chore(hooks): add check for outdated macro documentation

Refs: #466

Author: Xenira

.github/workflows/build.yml

@@ -71,6 +71,8 @@ jobs:
           echo "LLVM_CONFIG_PATH=${{ runner.temp }}/llvm-${{ env.clang }}/bin/llvm-config" >> $GITHUB_ENV
       - name: Run rustfmt
         run: cargo fmt --all -- --check
+      - name: macro docs
+        run: tools/update_lib_docs.sh && git diff --exit-code crates/macros/src/lib.rs
       - name: Run clippy
         run: cargo clippy --workspace --all-targets --all-features -- -W clippy::pedantic -D warnings
       # Docs

.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.