Revise documentation

.github/workflows/bvt-appleclang.yml

@@ -1,17 +1,11 @@
 on:
   workflow_call:
-    inputs:
-      branch:
-        type: string
-        required: false
 
 jobs:
   bvt-appleclang:
     runs-on: macos-15
     steps:
     - uses: actions/checkout@v4
-      with:
-        ref: ${{ inputs.branch }}
 
     - name: check compiler versions
       run: |

.github/workflows/bvt-clang.yml

@@ -1,17 +1,11 @@
 on:
   workflow_call:
-    inputs:
-      branch:
-        type: string
-        required: false
 
 jobs:
   bvt-clang:
     runs-on: ubuntu-24.04
     steps:
     - uses: actions/checkout@v4
-      with:
-        ref: ${{ inputs.branch }}
 
     - name: install clang
       run: |

.github/workflows/bvt-compatibility.yml

@@ -1,17 +1,11 @@
 on:
   workflow_call:
-    inputs:
-      branch:
-        type: string
-        required: false
 
 jobs:
   bvt-compatibility:
     runs-on: ubuntu-24.04
     steps:
     - uses: actions/checkout@v4
-      with:
-        ref: ${{ inputs.branch }}
 
     - name: install compilers
       run: |

.github/workflows/bvt-gcc.yml

@@ -1,17 +1,11 @@
 on:
   workflow_call:
-    inputs:
-      branch:
-        type: string
-        required: false
 
 jobs:
   bvt-gcc:
     runs-on: ubuntu-24.04
     steps:
     - uses: actions/checkout@v4
-      with:
-        ref: ${{ inputs.branch }}
 
     - name: install gcc
       run: |

.github/workflows/bvt-msvc.yml

@@ -1,17 +1,11 @@
 on:
   workflow_call:
-    inputs:
-      branch:
-        type: string
-        required: false
 
 jobs:
   bvt-msvc:
     runs-on: windows-2025
     steps:
     - uses: actions/checkout@v4
-      with:
-        ref: ${{ inputs.branch }}
 
     - name: add cl.exe to PATH
       uses: ilammy/msvc-dev-cmd@v1

.github/workflows/bvt-nvhpc.yml

@@ -1,17 +1,11 @@
 on:
   workflow_call:
-    inputs:
-      branch:
-        type: string
-        required: false
 
 jobs:
   bvt-nvhpc:
     runs-on: ubuntu-24.04
     steps:
     - uses: actions/checkout@v4
-      with:
-        ref: ${{ inputs.branch }}
 
     - name: install NVHPC 24.9
       run: |

.github/workflows/bvt-report.yml

@@ -1,17 +1,11 @@
 on:
   workflow_call:
-    inputs:
-      branch:
-        type: string
-        required: false
 
 jobs:
   bvt-report:
     runs-on: ubuntu-24.04
     steps:
     - uses: actions/checkout@v4
-      with:
-        ref: ${{ inputs.branch }}
 
     - name: download all workflow run artifacts
       uses: actions/download-artifact@v4

.github/workflows/mkdocs.yml

@@ -0,0 +1,34 @@
+on:
+  workflow_call:
+    inputs:
+      upload-artifacts:
+        type: boolean
+        default: false
+
+jobs:
+  bvt-mkdocs:
+    runs-on: ubuntu-24.04
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0 # Fetch all history for .GitInfo and .Lastmod
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+          architecture: "x64"
+
+      - name: Install dependencies
+        run: |
+          python3 -m pip install --upgrade pip
+          python3 -m pip install -r mkdocs/requirements.txt
+
+      - name: Build site
+        run: mkdocs build --strict
+
+      - name: Upload site artifact
+        if: ${{ inputs.upload-artifacts }}
+        uses: actions/upload-pages-artifact@v3
+        with:
+          path: ./site

.github/workflows/pipeline-ci.yml

@@ -36,3 +36,7 @@ jobs:
     uses: ./.github/workflows/bvt-report.yml
     name: Generate report
     needs: [run-bvt-gcc, run-bvt-clang, run-bvt-msvc, run-bvt-appleclang, run-bvt-nvhpc]
+
+  mkdocs:
+    uses: ./.github/workflows/mkdocs.yml
+    name: Build mkdocs

.github/workflows/pipeline-pages.yml

@@ -0,0 +1,27 @@
+name: Deploy docs to GitHub Pages
+
+on:
+  push:
+    branches:
+      - lkg
+
+jobs:
+  build:
+    uses: ./.github/workflows/mkdocs.yml
+    with:
+      upload-artifacts: true
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-24.04
+    permissions:
+      id-token: write
+      pages: write
+
+    environment:
+      name: github-pages
+      url: ${{ steps.deploy.outputs.page_url }}
+
+    steps:
+      - id: deploy
+        uses: actions/deploy-pages@v4

CMakeLists.txt

@@ -1,6 +1,6 @@
 cmake_minimum_required(VERSION 3.28)
 
-project(msft_proxy VERSION 3.3.0 LANGUAGES CXX)
+project(msft_proxy VERSION 4.0.0 LANGUAGES CXX)
 add_library(msft_proxy INTERFACE)
 
 # Do not enable building tests if proxy is consumed as

docs/.pages

@@ -0,0 +1,5 @@
+nav:
+  - Home: README.md
+  - Specifications: spec
+  - Modules Support: modules_support.md
+  - FAQ: faq.md

docs/CMakeLists.txt

@@ -1,5 +1,12 @@
 project(msft_proxy_docs)
 
+FetchContent_Declare(
+  fmt
+  URL https://github.com/fmtlib/fmt/archive/refs/tags/11.2.0.tar.gz
+  URL_HASH SHA256=ac366b7b4c2e9f0dde63a59b3feb5ee59b67974b14ee5dc9ea8ad78aa2c1ee1e
+)
+FetchContent_MakeAvailable(fmt)
+
 find_package(Python3 REQUIRED COMPONENTS Interpreter)
 
 file(GLOB_RECURSE DOC_FILES "*.md")
@@ -26,3 +33,5 @@ foreach(SOURCE ${EXAMPLE_SOURCES})
     target_compile_options(${EXECUTABLE_NAME} PRIVATE -Wall -Wextra -Wpedantic)
   endif()
 endforeach()
+
+target_link_libraries(example_spec_skills_fmt_format PRIVATE fmt::fmt)

docs/README.md

@@ -0,0 +1 @@
+../README.md