chore(hooks): add check for outdated macro documentation

Refs: #466

Author: Xenira

.github/workflows/macro_docs.yml

@@ -0,0 +1,30 @@
+name: macro docs
+on:
+  pull_request:
+    # paths:
+    #   - "guide/src/macros/*.md"
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint-bindings:
+    name: Lint bindings
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@master
+        with:
+          components: rustfmt
+          toolchain: nightly
+      - name: Cache cargo dependencies
+        uses: Swatinem/rust-cache@v2
+        with:
+          prefix-key: ${{ env.RUST_CACHE_PREFIX }}
+      - name: Macro docs
+        run: tools/update_lib_docs.sh && git diff --exit-code crates/macros/src/lib.rs

.lefthook.yml

@@ -11,3 +11,12 @@ pre-commit:
     - name: bindings
       run: tools/update_bindings.sh && git diff --exit-code docsrs_bindings.rs
       glob: "allowed_bindings.rs"
+      fail_text: |
+        The `docsrs_bindings.rs` file seems to be out of date.
+        Please check the updated bindings in `docsrs_bindings.rs` and commit the changes.
+    - name: "macro docs"
+      run: tools/update_lib_docs.sh && git diff --exit-code crates/macros/src/lib.rs
+      glob: "guide/src/macros/*.md"
+      fail_text: |
+        The macro crates documentation seems to be out of date.
+        Please check the updated documentation in `crates/macros/src/lib.rs` and commit the changes.

CONTRIBUTING.md

@@ -28,6 +28,8 @@ lefthook install
 - When changing the `allowed_bindings.rs`, you need to have `docker` and `buildx` installed. This is required to
   build the bindings in a consistent environment. See the [installation guide](https://docs.docker.com/engine/install/)
   for instructions on how to install Docker.
+- When updating the macro guides (`guide/src/macros`), you need to have the `nightly` toolchain installed. This is required
+  to have the proper formatting in the documentation.
 
 ## Testing