build: update workflows to use markdown-autodocs for improved documentation synchronization

Author: roboticswithjulia

.github/workflows/rust-minimal.yml

@@ -35,18 +35,13 @@ jobs:
     container:
       image: ${{ matrix.docker_image }}
     steps:
-    - uses: actions/checkout@v2
+    - name: Markdown autodocs
+    - uses: dineshsonachalam/markdown-autodocs@v1.0.7
       with:
-        persist-credentials: false # otherwise, the token used is the GITHUB_TOKEN, instead of your personal token
-        fetch-depth: 0 # otherwise, you will failed to push refs to dest repo
-        ref: refs/heads/${{ github.head_ref }}
-
-    - uses: technology-studio-forks/markdown-embed-code@main
-      with:
-        markdown: "docs/writing-your-first-rclrs-node.md"
-        token: ${{ secrets.GITHUB_TOKEN }}
-        message: "synchronizing Markdown files"
-        silent: false
+        commit_message: Synchronizing Markdown files
+        branch: ${{ github.head_ref }} 
+        output_file_paths: '[./docs/writing-your-first-rclrs-node.md]'
+        categories: '[code-block]'
 
     - name: Search packages in this repository
       id: list_packages

.github/workflows/rust-stable.yml

@@ -35,18 +35,13 @@ jobs:
     container:
       image: ${{ matrix.docker_image }}
     steps:
-    - uses: actions/checkout@v2
+    - name: Markdown autodocs
+    - uses: dineshsonachalam/markdown-autodocs@v1.0.7
       with:
-        persist-credentials: false # otherwise, the token used is the GITHUB_TOKEN, instead of your personal token
-        fetch-depth: 0 # otherwise, you will failed to push refs to dest repo
-        ref: refs/heads/${{ github.head_ref }}
-
-    - uses: technology-studio-forks/markdown-embed-code@main
-      with:
-        markdown: "docs/writing-your-first-rclrs-node.md"
-        token: ${{ secrets.GITHUB_TOKEN }}
-        message: "synchronizing Markdown files"
-        silent: false
+        commit_message: Synchronizing Markdown files
+        branch: ${{ github.head_ref }} 
+        output_file_paths: '[./docs/writing-your-first-rclrs-node.md]'
+        categories: '[code-block]'
 
     - name: Search packages in this repository
       id: list_packages

docs/writing-your-first-rclrs-node.md

@@ -148,18 +148,26 @@ If you couldn't follow the explanation involving borrowing, closures etc. above,
 
 The node still doesn't republish the received messages. First, let's add a publisher to the node:
 
-```rust:examples/minimal_pub_sub/src/first_rclrs_node.rs [5-10]
+```
+<!-- MARKDOWN-AUTO-DOCS:START (CODE:src=../examples/minimal_pub_sub/src/first_rclrs_node.rs&lines=5-10) -->
+<!-- MARKDOWN-AUTO-DOCS:END -->
 ```
 
 Create a publisher and add it to the newly instantiated `RepublisherNode`:
 
-```rust:examples/minimal_pub_sub/src/first_rclrs_node.rs [23-29]
 ```
+<!-- MARKDOWN-AUTO-DOCS:START (CODE:src=../examples/minimal_pub_sub/src/first_rclrs_node.rs&lines=23-29) -->
+<!-- MARKDOWN-AUTO-DOCS:END -->
+```
+
 
 Then, let's add a `republish()` function to the `RepublisherNode` that publishes the latest message received, or does nothing if none was received:
 
-```rust:examples/minimal_pub_sub/src/first_rclrs_node.rs [32-37]
 ```
+<!-- MARKDOWN-AUTO-DOCS:START (CODE:src=../examples/minimal_pub_sub/src/first_rclrs_node.rs&lines=32-37) -->
+<!-- MARKDOWN-AUTO-DOCS:END -->
+```
+
 
 What's left to do is to call this function every second. `rclrs` doesn't yet have ROS timers, which run a function at a fixed interval, but it's easy enough to achieve with a thread, a loop, and the sleep function. Change your main function to spawn a separate thread:
 
@@ -188,7 +196,9 @@ But wait, this doesn't work – there is an error about the thread closure needi
 
 The solution is also the same as above: Shared ownership with `Arc`. Only this time, `Mutex` isn't needed since both the `rclcpp::spin()` and the `republish()` function only require a shared reference:
 
-```rust:examples/minimal_pub_sub/src/first_rclrs_node.rs [40-55]
+```
+<!-- MARKDOWN-AUTO-DOCS:START (CODE:src=../examples/minimal_pub_sub/src/first_rclrs_node.rs&lines=40-55) -->
+<!-- MARKDOWN-AUTO-DOCS:END -->
 ```