From 59bacfcab3455a29e03e1e0e81083e86d7169748 Mon Sep 17 00:00:00 2001
From: Arnout Engelen <arnout.engelen@lightbend.com>
Date: Thu, 5 Mar 2020 17:51:16 +0100
Subject: [PATCH] Document developing on Nix (#246)

---
 CONTRIBUTING.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 3a12948e6..539f36466 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -62,6 +62,12 @@ install Xephyr and run the scripts
 - `utils/xephyr/start-xephyr.sh`
 - `utils/xephyr/xephyr-notion.sh`
 
+## Developing on NixOS
+
+When running NixOS, you can easily fetch the relevant dependencies with
+`nix-shell '<nixpkgs>' -A notion`. Unfortunately Xephyr on NixOS doesn't
+automatically load the X11 fonts, see https://github.com/NixOS/nixpkgs/issues/28599
+
 ## Releasing and versioning
 
 We don't publish binaries, that is up to the distributions.