[+] add docs versioning (#598)

Author: pashagolub

.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,41 @@ 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: Configure Git
+      run: |
+        git config user.name "${GITHUB_ACTOR}"
+        git config user.email "${GITHUB_ACTOR}@users.noreply.github.com"
+
+    - 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
+
+    - name: Install dependencies
+      run: pip install mike mkdocs-material mkdocs-glightbox
+
+    - name: Build mkdocs
+      run: mike --debug deploy devel

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