From 0c2092d74cf3d42eb58c50c60dff172bf7b2d1ed Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Amy=20de=20Buitl=C3=A9ir?= <amy@nualeargais.ie>
Date: Wed, 8 Oct 2025 19:19:50 +0100
Subject: [PATCH] temp

---
 source/generic-flake/main.adoc         | 10 ++++++----
 source/hello-flake-return/main.adoc    |  4 ++--
 source/nix-language/repl.adoc          |  2 +-
 source/recipes/build/nixpkg/main.adoc0 |  1 +
 4 files changed, 10 insertions(+), 7 deletions(-)

diff --git a/source/generic-flake/main.adoc b/source/generic-flake/main.adoc
index 60a0d41..2f67bb3 100644
--- a/source/generic-flake/main.adoc
+++ b/source/generic-flake/main.adoc
@@ -90,8 +90,10 @@ Below is a list of some functions that are commonly used in
 this section.
 
 General-purpose::
-  The standard environment provides `mkDerivation`, which is especially
-  useful for the typical `./configure; make; make install` scenario.
+  The standard environment provides
+  https://noogle.dev/f/pkgs/stdenv/mkDerivation[`mkDerivation`],
+  which is especially useful for the typical
+  `./configure; make; make install` scenario.
   It's customisable.
 Python::
   `buildPythonApplication`, `buildPythonPackage`.
@@ -102,6 +104,6 @@ Haskell::
 
 [NOTE]
 ====
-The https://noogle.dev/[Noogλe] search
-makes it easy to find documentation for Nix functions and other definitions.
+https://noogle.dev/[Noogλe] allows you to search for
+documentation for Nix functions and other definitions.
 ====
diff --git a/source/hello-flake-return/main.adoc b/source/hello-flake-return/main.adoc
index 362d43d..4647cb7 100644
--- a/source/hello-flake-return/main.adoc
+++ b/source/hello-flake-return/main.adoc
@@ -71,8 +71,8 @@ see what it does.
           };
 ....
 
-This flake uses `mkDerivation` `❶` which is a very useful
-general-purpose package builder provided by the Nix standard
+This flake uses https://noogle.dev/f/pkgs/stdenv/mkDerivation[`mkDerivation`] `❶`
+which is a very useful general-purpose package builder provided by the Nix standard
 environment. It's especially useful for the typical
 `./configure; make; make install` scenario, but for this flake we don't
 even need that.
diff --git a/source/nix-language/repl.adoc b/source/nix-language/repl.adoc
index 9e82480..85ce0df 100644
--- a/source/nix-language/repl.adoc
+++ b/source/nix-language/repl.adoc
@@ -1,6 +1,6 @@
 = The Nix REPL
 
-The Nix REPL footnote:[REPL is an acronym for (Read-Eval-Print-Loop).]
+The Nix REPL (REPL is an acronym for Read-Eval-Print-Loop)
 is an interactive environment for evaluating and debugging Nix code.
 It's also a good place to begin learning Nix.
 Enter it using the command `nix repl`.
diff --git a/source/recipes/build/nixpkg/main.adoc0 b/source/recipes/build/nixpkg/main.adoc0
index 88ff13b..1134063 100644
--- a/source/recipes/build/nixpkg/main.adoc0
+++ b/source/recipes/build/nixpkg/main.adoc0
@@ -52,6 +52,7 @@ See the section on https://nixos.org/manual/nixpkgs/stable/#chap-trivial-builder
 in the Nixpkgs reference manual, particularly
 https://nixos.org/manual/nixpkgs/stable/#trivial-builder-writeShellScript[writeShellScript]
 and https://nixos.org/manual/nixpkgs/stable/#trivial-builder-writeShellScriptBin[writeShellScriptBin].
+
 ////
 Good adoc0 scripts clean up after themselves.
 $ cd .. ; rm -rf tempwork # clean up