docs: Deploy both stable & unstable docs to github pages

.github/workflows/build_documentation.yml

@@ -44,12 +44,12 @@ jobs:
           name: nix-community
           authToken: '${{ secrets.CACHIX_AUTH_TOKEN }}'
 
-      - run: nix build .#docs --show-trace
+      - run: ./build-docs.sh
 
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: "result/share/doc"
+          path: "docs-build"
 
       - name: Deploy to GitHub Pages
         id: deployment

README.md

@@ -233,6 +233,8 @@ be.
 Documentation is available on this project's GitHub Pages page:
 [https://nix-community.github.io/nixvim](https://nix-community.github.io/nixvim)
 
+The stable documentation is also available at [https://nix-community.github.io/nixvim/stable](https://nix-community.github.io/nixvim/stable).
+
 If the option `enableMan` is set to `true` (by default it is), man pages will also
 be installed containing the same information, they can be viewed with `man nixvim`.
 

build-docs.sh

@@ -0,0 +1,9 @@
+#!/usr/bin/env sh
+
+set -ex
+
+mkdir -p docs-build
+nix build github:nix-community/nixvim#docs
+cp -r result/share/doc docs-build
+nix build github:nix-community/nixvim/nixos-23.11#docs
+cp -r result/share/doc docs-build/stable