Documentation Drift Report¶

[!info] Auto-Generated Validation Report This report compares static documentation against live system state. Last Validated: 2026-04-23 00:00:24 UTC Pattern: Reflection (self-validation)

Validation Summary¶

[danger] 🔴 Documentation Drift Detected Passed: 9 | Warnings: 7 | Errors: 2

Metric	Value
Total Checks	18
Passed	9
Warnings	7
Errors	2
Health Score	50%

pie title Validation Results
    "Passed" : 9
    "Warnings" : 7
    "Errors" : 2

Detailed Findings¶

Errors (Immediate Action Required)¶

[Services] Service count mismatch: Documented=, Actual=90
[Nodes] Node count mismatch: Documented=, Actual=5

Warnings (Review Recommended)¶

[Services] Documented service 'elasticsearch' not found in Swarm
[Services] Documented service 'logstash' not found in Swarm
[Services] Documented service 'mariadb' not found in Swarm
[Services] Documented service 'redis' not found in Swarm
[Services] Documented service 'prometheus' not found in Swarm
[Infrastructure] Docker version not documented
[Freshness] Over 50% of docs not updated in 7+ days (21/29)

Passed Checks¶

View all passed checks

- ✅ **[Services]** Service 'traefik' healthy: 1/1 - ✅ **[Storage]** Mount '/nfs_data' exists as documented - ✅ **[Storage]** Mount '/nfs_media' exists as documented - ✅ **[Storage]** Mount '/nfs_cams' exists as documented - ✅ **[Stacks]** Stack file 'stack-homenet1.yml' exists - ✅ **[Stacks]** Stack file 'stack-homenet2.yml' exists - ✅ **[Stacks]** Stack file 'stack-homenet3.yml' exists - ✅ **[Stacks]** Stack file 'stack-homenet4.yml' exists - ✅ **[Stacks]** Stack file 'stack-traefik.yml' exists

Recommendations¶

[!danger] Action Required Documentation has significant drift from reality. Update the following: 1. Review and update service counts in 00-Index.md 2. Verify all documented services exist 3. Check NFS mount documentation accuracy 4. Run ./scripts/docs/sh-update-docs.sh to regenerate auto-generated sections

How This Works¶

This validation implements the Reflection agentic pattern:

Read: Extracts claims from existing documentation
Query: Checks claims against live system state
Compare: Identifies discrepancies (drift)
Report: Generates actionable findings

Validation Categories¶

Services: Service counts, status, and health
Nodes: Cluster node documentation accuracy
Storage: NFS mount and capacity documentation
Infrastructure: Docker version, OS, configs
Freshness: Document update recency

Regeneration¶

To manually run validation:

./scripts/docs/sh-validate-docs.sh

Generated by Homenet Agentic Documentation System Pattern: Reflection (self-validation)