[+] add docs versioning

.github/workflows/build.yml

@@ -122,8 +122,10 @@ jobs:
     name: Build Docker Image
     runs-on: ubuntu-latest
     steps:
+
     - name: Check out code
       uses: actions/checkout@v4
+
     - name: Build Docker Image
       shell: bash
       run: |
@@ -132,4 +134,37 @@ jobs:
         --build-arg GIT_HASH=`git show -s --format=%H HEAD` \
         --build-arg VERSION=`git rev-parse --abbrev-ref HEAD` \
         -t cybertecpostgresql/pgwatch:latest \
-        -f docker/Dockerfile .   
+        -f docker/Dockerfile .   
+
+  build-docs:
+    if: true # false to skip job during debug
+    needs: build
+    name: Build Docs
+    runs-on: ubuntu-latest
+    steps:
+
+    - name: Check out code
+      uses: actions/checkout@v4
+
+    - name: Set up Golang
+      uses: actions/setup-go@v5
+      with:
+        go-version: '1.23'      
+
+    - name: Set up gopages
+      run: go install github.com/johnstarich/go/[email protected]
+
+    - name: Build Developer Docs
+      run: gopages -out "docs/godoc" -base "/godoc" -internal
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: 3.12
+        cache: 'pip'
+
+    - name: Install dependencies
+      run: pip install mkdocs-material mkdocs-glightbox
+
+    - name: Build mkdocs
+      run: mkdocs build

docs/_overrides/main.html

@@ -0,0 +1,8 @@
+{% extends "base.html" %}
+
+{% block outdated %}
+You're not viewing the latest version.
+<a href="{{ '../' ~ base_url }}">
+    <strong>Click here to go to latest.</strong>
+</a>
+{% endblock %}

mkdocs.yml

@@ -89,4 +89,8 @@ markdown_extensions:
   - pymdownx.inlinehilite
   - pymdownx.snippets
   - pymdownx.superfences
-  - attr_list
+  - attr_list
+
+extra:
+  version:
+    provider: mike