add basic structure for reference and commit on workflows

.github/workflows/deploy-docs.yaml

@@ -4,6 +4,7 @@ on:
   push:
     branches:
       - docs
+      - fix/docs-workflows
 
 jobs:
   deploy:
@@ -39,6 +40,19 @@ jobs:
       - name: Build website
         run: cd docs/vame-docs-app && yarn build
 
+      - name: Commit pydoc-markdown files
+        run: |
+          git config --local user.email "github-actions[bot]@users.noreply.github.com"
+          git config --local user.name "github-actions[bot]"
+          GIT_STATUS=$(git status -s)
+          [[ ! -z "$GIT_STATUS" ]] && git add docs/* && git commit -m "auto-commit-docs" -a || echo "No changes to commit"
+
+      - name: Push changes
+        uses: ad-m/github-push-action@master
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          branch: ${{ github.ref }}
+
       # Popular action to deploy to GitHub Pages:
       # Docs: https://github.com/peaceiris/actions-gh-pages#%EF%B8%8F-docusaurus
       - name: Deploy to GitHub Pages

docs/vame-docs-app/docs/reference/_category_.json

@@ -0,0 +1,8 @@
+{
+    "label": "API reference",
+    "position": 3,
+    "link": {
+        "type": "generated-index",
+        "description": "VAME package API reference"
+    }
+}