From 1dc21463e32c3d26e0d488a2ef1ab0deb8e2caf0 Mon Sep 17 00:00:00 2001
From: rfprod <zoidenmacht@zoho.com>
Date: Sat, 7 Nov 2026 12:47:38 +0400
Subject: [PATCH] ci(runners): pin ci runners to `ubuntu-24.04`, split API
 reference

- [x] pin `gh-pages` build and deploy jobs to `ubuntu-24.04` instead of `ubuntu-latest`;
- [x] pin `validate-codeowners` job to `ubuntu-24.04` instead of `ubuntu-latest`;
- [x] move the `C++ API reference` into a dedicated `docs/api_reference.rst` page;
- [x] add `api_reference` to the `docs/index.rst` `toctree` in place of the inline section;
---
 .github/workflows/gh-pages.yml            | 4 ++--
 .github/workflows/validate-codeowners.yml | 2 +-
 docs/api_reference.rst                    | 5 +++++
 docs/index.rst                            | 7 +------
 4 files changed, 9 insertions(+), 9 deletions(-)
 create mode 100644 docs/api_reference.rst

diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml
index 830d228..dc7f4af 100644
--- a/.github/workflows/gh-pages.yml
+++ b/.github/workflows/gh-pages.yml
@@ -16,7 +16,7 @@ concurrency:
 
 jobs:
   build:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     permissions:
       contents: read
       pages: read
@@ -118,7 +118,7 @@ jobs:
   deploy:
     if: github.ref == 'refs/heads/main' && (github.event_name == 'push' || github.event_name == 'workflow_dispatch')
     needs: build
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
     permissions:
       contents: read
       pages: write
diff --git a/.github/workflows/validate-codeowners.yml b/.github/workflows/validate-codeowners.yml
index ff9d85f..f2abbbc 100644
--- a/.github/workflows/validate-codeowners.yml
+++ b/.github/workflows/validate-codeowners.yml
@@ -17,7 +17,7 @@ concurrency:
 
 jobs:
   validate-codeowners:
-    runs-on: ubuntu-latest
+    runs-on: ubuntu-24.04
 
     steps:
       - name: Checkout sources
diff --git a/docs/api_reference.rst b/docs/api_reference.rst
new file mode 100644
index 0000000..641b809
--- /dev/null
+++ b/docs/api_reference.rst
@@ -0,0 +1,5 @@
+C++ API reference
+=================
+
+.. doxygenindex::
+   :project: cpp-workspace
diff --git a/docs/index.rst b/docs/index.rst
index b777080..76c8929 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -5,10 +5,5 @@ cpp-workspace documentation
    :maxdepth: 2
    :caption: Contents
 
+   api_reference
    test_coverage
-
-C++ API reference
------------------
-
-.. doxygenindex::
-   :project: cpp-workspace