docs: user-guide/helpers.md → lib/index.md

Move the user-guide to the new lib reference docs.

Added a MDBook redirect entry.

Updated man docs.

docs/default.nix

@@ -108,7 +108,10 @@ lib.fix (
 
     gfm-alerts-to-admonitions = pkgs.python3.pkgs.callPackage ./gfm-alerts-to-admonitions { };
 
-    man-docs = pkgs.callPackage ./man { inherit options-json; };
+    man-docs = pkgs.callPackage ./man {
+      inherit options-json;
+      inherit (self) lib-docs;
+    };
 
     lib-docs = pkgs.callPackage ./lib {
       inherit nixvim lib;

docs/lib/pages.nix

@@ -4,5 +4,9 @@
 # If there is an issue parsing the file, the resulting markdown will not contain any function docs.
 
 {
-  # TODO
+  lib.pages = {
+    nixvim = {
+      markdown = ./index.md;
+    };
+  };
 }

docs/man/default.nix

@@ -1,6 +1,7 @@
 {
   lib,
   options-json,
+  lib-docs,
   runCommand,
   installShellFiles,
   nixos-render-docs,
@@ -23,7 +24,7 @@ let
           cat ${./nixvim-header-start.5}
 
           ${lib.concatMapStringsSep "\n" (file: "mkMDSection ${file}") [
-            ../user-guide/helpers.md
+            "${lib-docs}/lib/index.md"
             ../user-guide/faq.md
             ../user-guide/config-examples.md
           ]}

docs/mdbook/SUMMARY.md

@@ -5,7 +5,6 @@
 # User guide
 
 - [Installation](./user-guide/install.md)
-- [Helpers](./user-guide/helpers.md)
 - [FAQ](./user-guide/faq.md)
 - [Configuration examples](./user-guide/config-examples.md)
 - [Lazy Loading](./user-guide/lazy-loading.md)

docs/mdbook/book.toml

@@ -10,6 +10,11 @@ site-url = "@SITE_URL@"
 additional-js = ["theme/pagetoc.js"]
 additional-css = ["theme/pagetoc.css"]
 
+# Redirect targets must be relative to their origin;
+# absolute paths can break with different baseHrefs.
+[output.html.redirect]
+"/user-guide/helpers.html" = "../lib/index.html" # Since #3049
+
 [output.html.fold]
 enable = true
 level = 0