diff --git a/default.nix b/default.nix
index 514249a69d..863d911a4a 100644
--- a/default.nix
+++ b/default.nix
@@ -1,4 +1,4 @@
-{ rev ? "a7855f2235a1876f97473a76151fec2afa02b287", # nixpkgs master. Keep up to date with flake.lock
+{ rev ? "a7855f2235a1876f97473a76151fec2afa02b287", # nixpkgs master. Keep up to date with "nixpkgs">"locked">"rev" in flake.lock
 nixpkgsSource ? builtins.fetchTarball {
   url = "https://github.com/nixos/nixpkgs/tarball/${rev}";
   sha256 = "sha256-5DGKX81wIPAAiLwUmUYECpA3vop94AHHR7WmGXSsQok=";
diff --git a/flake.nix b/flake.nix
index 9ce8a1cc6d..6ab1cee498 100644
--- a/flake.nix
+++ b/flake.nix
@@ -129,6 +129,7 @@
 
         formatter = pkgs.nixpkgs-fmt;
 
+        # You can build this package (the compiler) with the `nix build` command.
         packages.default = import ./. { inherit pkgs; };
       });
 }