feat: introduce development shell

flakes are not stable yet, community is divided but maintaining both
flake and a set of dependencies in our scripts is hard.
So provide a nix-shell that fetches the nixpkgs recorded in the
flake.lock to keep a single source of truth

doc: updated the doc to advise `nix-shell -A dev`

Makefile

@@ -17,4 +17,4 @@ test-install:
 	HOME=$(shell mktemp -d) NIX_PATH=${NIX_PATH} nix-shell . -A install
 
 format:
-	nix-shell -p treefmt nixfmt deadnix keep-sorted nixf-diagnose --run "treefmt --config-file ./treefmt.toml"
+	nix-shell -A dev --run treefmt

default.nix

@@ -8,6 +8,18 @@ let
     name = "home-manager-source";
   };
 
+  nixpkgs = (
+    import (
+      let
+        lock = builtins.fromJSON (builtins.readFile ./flake.lock);
+        n = lock.nodes.nixpkgs.locked;
+      in
+      fetchTarball {
+        url = "https://github.com/${n.owner}/${n.repo}/archive/${n.rev}.tar.gz";
+        sha256 = n.narHash;
+      }
+    ) { }
+  );
 in
 rec {
   docs =
@@ -32,5 +44,7 @@ rec {
   nixos = import ./nixos;
   lib = import ./lib { inherit (pkgs) lib; };
 
+  dev = nixpkgs.callPackage ./home-manager/devShell.nix { };
+
   inherit path;
 }

docs/manual/contributing/news.md

@@ -19,7 +19,7 @@ but you should follow some basic guidelines:
     Alternatively, you can directly use the script:
 
     ``` shell
-    $ modules/misc/news/create-news-entry.sh
+    $ nix-shell -A dev --run modules/misc/news/create-news-entry.sh
     ```
 
     This will create a new file inside the `modules/misc/news` directory