Skip to content

Fix strict MkDocs build scope for repository-root docs_dir #35

Description

@oldrepublicwizard

Residual review finding (P1): mkdocs.yml:4\n\nStrict MkDocs gate can fail when docs_dir scans the entire repository and traverses non-doc trees/symlink paths.\n\nSuggested fix:\n- Either move to docs_dir: docs and explicitly include intended pages, or\n- Keep docs_dir: . and add exclude_docs patterns for non-doc trees and broken paths (at minimum volumes/, plus vendor/ and node_modules/** as applicable).\n\nVerification:\n- docker run --rm -v "/home/ubuntu/my-media-stack:/docs" -w /docs squidfunk/mkdocs-material:latest build -f mkdocs.yml --strict\n\nSource: LFG step 3 code review finding F1 (2026-06-03).

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions