diff --git a/pills/08-generic-builders.xml b/pills/08-generic-builders.xml
index 182d9a0..0a4061b 100644
--- a/pills/08-generic-builders.xml
+++ b/pills/08-generic-builders.xml
@@ -48,6 +48,12 @@
     </para>
 
     <screen><xi:include href="./08/hello-nix.txt" parse="text" /></screen>
+    <note><title>Nix on darwin</title>
+    <para>The darwin (i.e. macOS) <literal>stdenv</literal> diverges from the Linux <literal>stdenv</literal> in several ways. A main difference is that the darwin <literal>stdenv</literal> relies upon <literal>clang</literal> rather than <literal>gcc</literal> as its C compiler. We can adapt this early example of how a <literal>stdenv</literal> works for darwin by using this modified version of <filename>hello.nix</filename>:
+    </para>
+    <screen><xi:include href="./08/hello-nix-darwin.txt" parse="text" /></screen>
+    Please be aware that similar changes may be needed in what follows.
+    </note>
 
     <para>
       Now build it with <command>nix-build hello.nix</command> and you can
diff --git a/pills/08/hello-nix-darwin.txt b/pills/08/hello-nix-darwin.txt
new file mode 100644
index 0000000..b9f0d71
--- /dev/null
+++ b/pills/08/hello-nix-darwin.txt
@@ -0,0 +1,11 @@
+with (import <nixpkgs> {});
+derivation {
+  name = "hello";
+  builder = "${bash}/bin/bash";
+  args = [ ./hello_builder.sh ];
+  inherit gnutar gzip gnumake coreutils gawk gnused gnugrep;
+  gcc = clang;
+  binutils_unwrapped = clang.bintools.bintools_bin;
+  src = ./hello-2.10.tar.gz;
+  system = builtins.currentSystem;
+}