Add CI job for docs (backport #424) (#427)

Author: mergify[bot]

.github/workflows/jazzy-check-docs.yml

@@ -0,0 +1,29 @@
+name: Jazzy Check Docs
+
+on:
+  workflow_dispatch:
+  pull_request:
+    branches:
+      - jazzy
+    paths:
+      - '**.rst'
+      - '**.md'
+      - '**.jpg'
+      - '**.jpeg'
+      - '**.png'
+      - '**.svg'
+      - '**.yml'
+      - '**.yaml'
+      - '!.github/**' # exclude yaml files in .github directory
+      - '.github/workflows/jazzy-check-docs.yml'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  check-docs:
+    name: Check Docs
+    uses: ros-controls/control.ros.org/.github/workflows/reusable-sphinx-check-single-version.yml@jazzy
+    with:
+      CONTROL_TOOLBOX_PR: ${{ github.ref }}

.github/workflows/rolling-check-docs.yml

@@ -0,0 +1,29 @@
+name: Rolling Check Docs
+
+on:
+  workflow_dispatch:
+  pull_request:
+    branches:
+      - ros2-master
+    paths:
+      - '**.rst'
+      - '**.md'
+      - '**.jpg'
+      - '**.jpeg'
+      - '**.png'
+      - '**.svg'
+      - '**.yml'
+      - '**.yaml'
+      - '!.github/**' # exclude yaml files in .github directory
+      - '.github/workflows/rolling-check-docs.yml'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  check-docs:
+    name: Check Docs
+    uses: ros-controls/control.ros.org/.github/workflows/reusable-sphinx-check-single-version.yml@rolling
+    with:
+      CONTROL_TOOLBOX_PR: ${{ github.ref }}

doc/migration.rst

@@ -1,4 +1,4 @@
-:github_url: https://github.com/ros-controls/realtime_tools/blob/{REPOS_FILE_BRANCH}/doc/migration.rst
+:github_url: https://github.com/ros-controls/control_toolbox/blob/{REPOS_FILE_BRANCH}/doc/migration.rst
 
 Migration Guides: Humble to Jazzy
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
@@ -10,4 +10,4 @@ This list summarizes important changes between Humble (previous) and Jazzy (curr
 
 Pid/PidRos
 ***********************************************************
-* The parameters :paramref:`antiwindup`, :paramref:`i_clamp_max`, and :paramref:`i_clamp_min` will be removed. The anti-windup behavior is now configured via the :paramref:`AntiWindupStrategy` enum. (`#298 <https://github.com/ros-controls/control_toolbox/pull/298>`_).
+* The parameters ``antiwindup``, ``i_clamp_max``, and ``i_clamp_min`` will be removed. The anti-windup behavior is now configured via the ``AntiWindupStrategy`` enum. (`#298 <https://github.com/ros-controls/control_toolbox/pull/298>`_).

doc/release_notes.rst

@@ -1,4 +1,4 @@
-:github_url: https://github.com/ros-controls/realtime_tools/blob/{REPOS_FILE_BRANCH}/doc/release_notes.rst
+:github_url: https://github.com/ros-controls/control_toolbox/blob/{REPOS_FILE_BRANCH}/doc/release_notes.rst
 
 Release Notes: Humble to Jazzy
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^