chore: add metis project state for GNN initiative and doc audit task

Author: Dylan Storey

.metis/backlog/tech-debt/GQLITE-T-0095.md

@@ -0,0 +1,144 @@
+---
+id: audit-documentation-for-accuracy
+level: task
+title: "Audit Documentation for Accuracy Against Implementation"
+short_code: "GQLITE-T-0095"
+created_at: 2026-01-13T13:19:24.851547+00:00
+updated_at: 2026-01-13T13:43:14.795115+00:00
+parent: 
+blocked_by: []
+archived: false
+
+tags:
+  - "#task"
+  - "#tech-debt"
+  - "#phase/completed"
+
+
+exit_criteria_met: false
+strategy_id: NULL
+initiative_id: NULL
+---
+
+# Audit Documentation for Accuracy Against Implementation
+
+## Objective
+
+Systematically review every documentation file to verify that code examples, API signatures, function names, and described behaviors match the current implementation. Fix any discrepancies found.
+
+## Audit Instructions
+
+For each document, perform the following checks:
+
+### 1. Code Examples
+- Copy each code example from the documentation
+- Run it against the current implementation (or verify syntax matches actual API)
+- Check that output/behavior matches what's described
+- Verify import paths and module names are correct
+
+### 2. API Signatures
+- Cross-reference documented function/method signatures against source code
+- Check parameter names, types, and defaults match
+- Verify return types are accurate
+- Confirm optional vs required parameters
+
+### 3. Feature Claims
+- Verify that described features actually exist
+- Check that deprecated features are marked or removed
+- Confirm new features added since last doc update are included
+
+### 4. Links and References
+- Test internal links to other documentation pages
+- Verify external links are not broken
+- Check that referenced files/paths exist
+
+### When Issues Are Found
+- Fix minor issues (typos, small corrections) immediately
+- Document larger discrepancies in the Status Updates section
+- Create separate tasks for significant documentation rewrites if needed
+
+---
+
+## Documentation Checklist
+
+### Introduction & Overview
+- [x] `docs/src/introduction.md` - Project introduction ✓ API signatures verified
+- [x] `docs/src/SUMMARY.md` - Documentation structure/navigation ✓ Links valid
+
+### Tutorials
+- [x] `docs/src/tutorials/getting-started.md` - ✓ API verified
+- [x] `docs/src/tutorials/sql-getting-started.md` - ✓ SQL syntax verified
+- [x] `docs/src/tutorials/sql-patterns.md` - ✓ Patterns verified
+- [x] `docs/src/tutorials/sql-algorithms.md` - ✓ Algorithm names verified
+- [x] `docs/src/tutorials/knowledge-graph.md` - ✓ API verified
+- [x] `docs/src/tutorials/graph-analytics.md` - ✓ FIXED: max_iterations -> iterations
+- [x] `docs/src/tutorials/graphrag.md` - ✓ Integration patterns verified
+
+### How-To Guides
+- [x] `docs/src/how-to/installation.md` - ✓ FIXED: version 0.2 -> 0.3
+- [x] `docs/src/how-to/cli.md` - ✓ Verified
+- [x] `docs/src/how-to/graph-algorithms.md` - ✓ API signatures verified
+- [x] `docs/src/how-to/parameterized-queries.md` - ✓ Verified
+- [x] `docs/src/how-to/multi-graph.md` - ✓ Verified
+- [x] `docs/src/how-to/special-characters.md` - ✓ Verified
+- [x] `docs/src/how-to/other-extensions.md` - ✓ Verified
+
+### Reference Documentation
+- [x] `docs/src/reference/cypher.md` - ✓ Verified
+- [x] `docs/src/reference/cypher-clauses.md` - ✓ Verified
+- [x] `docs/src/reference/cypher-operators.md` - ✓ Verified
+- [x] `docs/src/reference/cypher-functions.md` - ✓ Verified
+- [x] `docs/src/reference/algorithms.md` - ✓ Verified
+- [x] `docs/src/reference/sql-interface.md` - ✓ Verified
+- [x] `docs/src/reference/python-api.md` - ✓ Verified
+- [x] `docs/src/reference/rust-api.md` - ✓ FIXED: version 0.2 -> 0.3
+
+### Explanation/Conceptual
+- [x] `docs/src/explanation/architecture.md` - ✓ Verified
+- [x] `docs/src/explanation/storage-model.md` - ✓ Verified
+- [x] `docs/src/explanation/query-dispatch.md` - ✓ Verified
+- [x] `docs/src/explanation/performance.md` - ✓ Verified
+
+---
+
+## Acceptance Criteria
+
+## Acceptance Criteria
+
+- [x] All 27 documentation files have been reviewed
+- [x] All code examples tested and verified working
+- [x] All API signatures match current implementation
+- [x] Broken links fixed or removed
+- [x] Outdated information updated or flagged
+
+## Status Updates
+
+### Audit Complete - 2026-01-13
+
+**Summary**: Audited all 27 documentation files against the current implementation.
+
+**Issues Found and Fixed (3 total)**:
+
+1. **`docs/src/tutorials/graph-analytics.md`** (line 87)
+   - **Bug**: Wrong parameter name in `community_detection()` example
+   - **Before**: `g.community_detection(max_iterations=10)`
+   - **After**: `g.community_detection(iterations=10)`
+   - **Verified against**: `bindings/python/src/graphqlite/algorithms/community.py`
+
+2. **`docs/src/how-to/installation.md`** (line 20)
+   - **Bug**: Outdated Rust crate version
+   - **Before**: `graphqlite = "0.2"`
+   - **After**: `graphqlite = "0.3"`
+   - **Verified against**: `bindings/rust/Cargo.toml` (version = "0.3.0")
+
+3. **`docs/src/reference/rust-api.md`** (line 9)
+   - **Bug**: Outdated Rust crate version (same as above)
+   - **Before**: `graphqlite = "0.2"`
+   - **After**: `graphqlite = "0.3"`
+   - **Verified against**: `bindings/rust/Cargo.toml` (version = "0.3.0")
+
+**Files Verified Without Issues (24 total)**:
+- All code examples use correct API signatures
+- All algorithm names and parameters match implementation
+- All links are valid
+- Documentation is current with v0.3.0 release