ci: auto-generate docs

.github/workflows/ci.yml

@@ -12,8 +12,7 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  unit_tests:
+  tests:
-    name: unit tests
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
@@ -51,3 +50,24 @@ jobs:
           export VIM="${PWD}/_neovim/share/nvim/runtime"
           nvim --version
           make test
+
+  docs:
+    runs-on: ubuntu-latest
+    needs: tests
+    if: ${{ github.ref == 'refs/heads/main' }}
+    steps:
+      - uses: actions/checkout@v3
+      - name: panvimdoc
+        uses: kdheepak/panvimdoc@main
+        with:
+          vimdoc: persisted.nvim
+          version: "Neovim >= 0.7.0"
+          demojify: true
+          treesitter: true
+      - name: Push changes
+        uses: stefanzweifel/git-auto-commit-action@v4
+        with:
+          commit_message: "chore(build): auto-generate vimdoc"
+          commit_user_name: "github-actions[bot]"
+          commit_user_email: "github-actions[bot]@users.noreply.github.com"
+          commit_author: "github-actions[bot] <github-actions[bot]@users.noreply.github.com>"