From 0ca05fd6dc6573202a51a6f2e46994bc0f94bb55 Mon Sep 17 00:00:00 2001
From: Valentin Gagarin <valentin.gagarin@tweag.io>
Date: Thu, 8 Jun 2023 02:18:51 +0200
Subject: [PATCH] glossary: add links to manuals and source code (#550)

---
 source/reference/glossary.md | 30 +++++++++++++++++++++++++-----
 1 file changed, 25 insertions(+), 5 deletions(-)

diff --git a/source/reference/glossary.md b/source/reference/glossary.md
index 5998eb3..6d739c7 100644
--- a/source/reference/glossary.md
+++ b/source/reference/glossary.md
@@ -6,25 +6,45 @@ Nix
 
     Read /nɪks/ ("Niks").
 
+    :::{seealso}
+    - [Nix Reference Manual](https://nixos.org/manual/nix)
+    - [Nix source code](https://github.com/NixOS/nix)
+    :::
+
 Nix language
-    Programming language to declare packages and configurations for Nix.
+    Programming language to declare packages and configurations for {term}`Nix`.
+
+    :::{seealso}
+    - [Nix language tutorial](reading-nix-language)
+    - [Nix language reference](https://nixos.org/manual/nix/stable/language)
+    :::
 
 Nix expression
-    Expression written in the Nix language.
+    Expression written in the {term}`Nix language`.
 
 Nix file
-    File (`.nix`) containing a Nix expression.
+    File (`.nix`) containing a {term}`Nix expression`.
 
 Nixpkgs
-    Software distribution built with Nix.
+    Software distribution built with {term}`Nix`.
 
     Read /nɪks ˈpækɪʤɪz/ ("Nix packages").
 
+    :::{seealso}
+    - [Nixpkgs Reference Manual](https://nixos.org/manual/nixpkgs)
+    - [Nixpkgs source code](https://github.com/NixOS/nixpkgs)
+    :::
+
 NixOS
-    Linux distribution based on Nix and Nixpkgs.
+    Linux distribution based on {term}`Nix` and {term}`Nixpkgs`.
 
     Read /nɪks oʊ ɛs/ ("Niks Oh Es").
 
+    :::{seealso}
+    - [NixOS Reference Manual](https://nixos.org/manual/nixos)
+    - [NixOS source code](https://github.com/NixOS/nixpkgs/tree/master/nixos)
+    :::
+
 reproducible
     Reproducibility would guarantee exactly the same results no matter
     **when** or **on what machine** you run the command.