docs: add notes on nix and small step

2 files changed, 65 insertions, 1 deletions

diff --git a/learn/nix/README.md b/learn/nix/README.md
new file mode 100644
index 0000000..84a0a0c
--- /dev/null
+++ b/learn/nix/README.md
@@ -0,0 +1,63 @@
+# Nix
+
+Is:
+
+1. An operating system
+2. A package manager
+3. A language
+
+You might need:
+
+```bash
+$ cat ~/.config/nix/nix.conf
+experimental-features = nix-command flakes
+```
+
+You will want to be on the appropriate channel.
+You can configure a channel for the system and/or your own profile.
+
+You can list the current channels via `nix-channel`
+```bash
+$ sudo -i nix-channel --list
+Password:
+nixpkgs https://channels.nixos.org/nixpkgs-22.05-darwin
+$ nix-channel --list
+```
+
+You can add the appropriate channel to the system using a root shell:
+
+```bash
+# nix-channel --add https://channels.nixos.org/nixpkgs-22.05-darwin nixpkgs
+```
+
+There's a new release twice a year in May and November.
+
+e.g.
+
+* nixpkgs-21.05
+* nixpkgs-21.11
+* nixpkgs-22.05
+
+You can update the channel with the latest package index via:
+
+```bash
+# nix-channel --update
+```
+
+## zerocmd/gatekeeper
+
+Build the default package flake in the current directory.
+
+```bash
+$ nix build .#
+```
+
+## zerocmd/infrastructure
+
+Running the e2e tests:
+
+```bash
+$ jive cd zerocmd/infrastructure
+$ nix develop
+$ nix build nixos-tests/gatekeeper.nix
+```
diff --git a/learn/smallstep/README.md b/learn/smallstep/README.md
index 231660b..0b25ba7 100644
--- a/learn/smallstep/README.md
+++ b/learn/smallstep/README.md
@@ -15,7 +15,8 @@ The root certificate has been saved in /Users/xlgmokha/.step/certs/root_ca.crt.
 The authority configuration has been saved in /Users/xlgmokha/.step/config/defaults.json.
 ```
 
-Generate a new certificate for local development.
+Generate a new certificate for local development. Note: You will need to allow
+incoming connections via tailscale preferences.
 
 ```bash
 $ step ca certificate localhost /tmp/localhost.crt /tmp/localhost.key