Omnitrace docs refactoring

.clang-tidy

@@ -23,6 +23,7 @@ performance-*,\
 readability-*,\
 -readability-function-size,\
 -readability-identifier-naming,\
+-readability-identifier-length,\
 -readability-implicit-bool-cast,\
 -readability-inconsistent-declaration-parameter-name,\
 -readability-named-parameter,\

.github/CODEOWNERS

@@ -4,3 +4,4 @@
 docs/* @ROCm/rocm-documentation
 *.md @ROCm/rocm-documentation
 *.rst @ROCm/rocm-documentation
+.readthedocs.yaml @ROCm/rocm-documentation

.github/dependabot.yml

@@ -9,3 +9,14 @@ updates:
     directory: "/" # Location of package manifests
     schedule:
       interval: "weekly"
+
+  - package-ecosystem: "pip" # See documentation for possible values
+    directory: "/docs/sphinx" # Location of package manifests
+    open-pull-requests-limit: 10
+    schedule:
+      interval: "daily"
+    labels:
+      - "documentation"
+      - "dependencies"
+    reviewers:
+      - "samjwu"

.github/workflows/containers.yml

@@ -29,14 +29,10 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          - distro: "ubuntu"
-            version: "18.04"
           - distro: "ubuntu"
             version: "20.04"
           - distro: "ubuntu"
             version: "22.04"
-          - distro: "opensuse"
-            version: "15.2"
           - distro: "opensuse"
             version: "15.3"
           - distro: "opensuse"
@@ -86,22 +82,6 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          # ubuntu 18.04
-          - os-distro: "ubuntu"
-            os-version: "18.04"
-            rocm-version: "0.0"
-          - os-distro: "ubuntu"
-            os-version: "18.04"
-            rocm-version: "4.5"
-          - os-distro: "ubuntu"
-            os-version: "18.04"
-            rocm-version: "5.0"
-          - os-distro: "ubuntu"
-            os-version: "18.04"
-            rocm-version: "5.1"
-          - os-distro: "ubuntu"
-            os-version: "18.04"
-            rocm-version: "5.2"
           # ubuntu 20.04
           - os-distro: "ubuntu"
             os-version: "20.04"

.github/workflows/cpack.yml

@@ -9,6 +9,7 @@ on:
       - v*
     paths-ignore:
       - '*.md'
+      - 'docs/**'
       - 'source/docs/**'
   pull_request:
     branches: [main]
@@ -31,10 +32,6 @@ jobs:
       fail-fast: false
       matrix:
         include:
-          # ubuntu 18.04
-          - os-distro: "ubuntu"
-            os-version: "18.04"
-            rocm-version: "0.0"
           # ubuntu 20.04
           - os-distro: "ubuntu"
             os-version: "20.04"
@@ -54,6 +51,9 @@ jobs:
           - os-distro: "ubuntu"
             os-version: "20.04"
             rocm-version: "6.0"
+          - os-distro: "ubuntu"
+            os-version: "20.04"
+            rocm-version: "6.1"
           # ubuntu 22.04
           - os-distro: "ubuntu"
             os-version: "22.04"
@@ -73,6 +73,9 @@ jobs:
           - os-distro: "ubuntu"
             os-version: "22.04"
             rocm-version: "6.0"
+          - os-distro: "ubuntu"
+            os-version: "22.04"
+            rocm-version: "6.1"
           # opensuse 15.3
           - os-distro: "opensuse"
             os-version: "15.3"
@@ -114,13 +117,19 @@ jobs:
           - os-distro: "opensuse"
             os-version: "15.4"
             rocm-version: "6.0"
+          - os-distro: "opensuse"
+            os-version: "15.4"
+            rocm-version: "6.1"
           # opensuse 15.5
           - os-distro: "opensuse"
             os-version: "15.5"
             rocm-version: "0.0"
           - os-distro: "opensuse"
             os-version: "15.5"
             rocm-version: "6.0"
+          - os-distro: "opensuse"
+            os-version: "15.5"
+            rocm-version: "6.1"
           # RHEL 8.7
           - os-distro: "rhel"
             os-version: "8.7"
@@ -153,13 +162,19 @@ jobs:
           - os-distro: "rhel"
             os-version: "8.8"
             rocm-version: "6.0"
+          - os-distro: "rhel"
+            os-version: "8.8"
+            rocm-version: "6.1"
           # RHEL 8.9
           - os-distro: "rhel"
             os-version: "8.9"
             rocm-version: "0.0"
           - os-distro: "rhel"
             os-version: "8.9"
             rocm-version: "6.0"
+          - os-distro: "rhel"
+            os-version: "8.9"
+            rocm-version: "6.1"
           # RHEL 9.1
           - os-distro: "rhel"
             os-version: "9.1"
@@ -183,13 +198,19 @@ jobs:
           - os-distro: "rhel"
             os-version: "9.2"
             rocm-version: "6.0"
+          - os-distro: "rhel"
+            os-version: "9.2"
+            rocm-version: "6.1"
           # RHEL 9.3
           - os-distro: "rhel"
             os-version: "9.3"
             rocm-version: "0.0"
           - os-distro: "rhel"
             os-version: "9.3"
             rocm-version: "6.0"
+          - os-distro: "rhel"
+            os-version: "9.3"
+            rocm-version: "6.1"
 
     steps:
       - name: Free Disk Space

.github/workflows/docs.yml

@@ -49,7 +49,7 @@ jobs:
           conda activate omnitrace-docs
           ./update-docs.sh
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@v1
+        uses: actions/upload-pages-artifact@v3
         with:
           path: ./docs
 
@@ -67,4 +67,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v1
+        uses: actions/deploy-pages@v4

.github/workflows/opensuse.yml

@@ -6,6 +6,7 @@ on:
     branches: [ main, develop ]
     paths-ignore:
       - '*.md'
+      - 'docs/**'
       - 'source/docs/**'
       - 'source/python/gui/**'
       - '.github/workflows/docs.yml'
@@ -17,6 +18,7 @@ on:
     branches: [ main, develop ]
     paths-ignore:
       - '*.md'
+      - 'docs/**'
       - 'source/docs/**'
       - 'source/python/gui/**'
       - '.github/workflows/docs.yml'
@@ -42,11 +44,11 @@ jobs:
       fail-fast: false
       matrix:
         compiler: ['g++']
-        os-release: [ '15.2', '15.3', '15.4' ]
+        os-release: [ '15.3', '15.4' ]
         build-type: ['Release']
 
     steps:
-    - uses: actions/checkout@v3
+    - uses: actions/checkout@v4
 
     - name: Install Packages
       timeout-minutes: 25

.github/workflows/redhat.yml

@@ -6,6 +6,7 @@ on:
     branches: [ main, develop ]
     paths-ignore:
       - '*.md'
+      - 'docs/**'
       - 'source/docs/**'
       - 'source/python/gui/**'
       - '.github/workflows/docs.yml'
@@ -17,6 +18,7 @@ on:
     branches: [ main, develop ]
     paths-ignore:
       - '*.md'
+      - 'docs/**'
       - 'source/docs/**'
       - 'source/python/gui/**'
       - '.github/workflows/docs.yml'