docs: auto-generate devshell.toml.md

default.nix

@@ -5,8 +5,11 @@ rec {
   # CLI
   cli = pkgs.callPackage ./devshell { };
 
+  # Get the modules documentation from an empty evaluation
+  modules-docs = (eval { configuration = { }; }).config.modules-docs;
+
   # Docs
-  docs = pkgs.callPackage ./docs { };
+  docs = pkgs.callPackage ./docs { inherit modules-docs; };
 
   # Evaluate the devshell module
   eval = import ./modules pkgs;

devshell.toml

@@ -17,7 +17,7 @@ packages = [
   "go",
   "goreleaser",
   "mdbook",
-  "mdsh",
+  "webfs",
 ]
 
 # Use this section to set environment variables to have in the environment.

docs/default.nix

@@ -1,4 +1,5 @@
 { mdbook
+, modules-docs
 , stdenv
 }:
 let
@@ -16,6 +17,7 @@ stdenv.mkDerivation {
   };
 
   buildPhase = ''
+    cp ${modules-docs.markdown} devshell.toml.md
     mdbook build
   '';
 

docs/serve.sh

@@ -0,0 +1,4 @@
+#!/usr/bin/env bash
+# Build and serve the docs for local development
+set -euo pipefail
+webfsd -d -r "$(nix-build "$(dirname "$0")/.." -A docs)"

modules/default.nix

@@ -21,7 +21,5 @@ in
 
   activationPackage = module.config.devshell.activationPackage;
 
-  docs = module.config.devshell.docs;
-
   shell = module.config.devshell.shell;
 }

modules/devshell.nix

@@ -134,8 +134,10 @@ in
 {
   options.devshell = {
     bashPackage = mkOption {
+      internal = true;
       type = strOrPackage;
       default = pkgs.bashInteractive;
+      defaultText = "pkgs.bashInteractive";
       description = "Version of bash to use in the project";
     };