Harden product documentation synchronization - #94
Merged
Merged
Conversation
Preserve Components navigation and nested DocFX toc links while rejecting Markdown-only MDX expansion. Add fence-aware lint guards for generated syntax errors and regression coverage for each conversion path.
Repository control files (AGENTS.md, CLAUDE.md, GEMINI.md) that live at the product source root for tooling/AI setup are now excluded from the generated documentation site, while preserving legitimate authored pages with matching names elsewhere in the documentation tree. Changed: - Skip AGENTS.md, CLAUDE.md, and GEMINI.md at product.src root only. - Preserve nested documentation pages named agents.md/claude.md/gemini.md. - Apply exclusion to both primary product sources and familySources. - Keep README.md exclusion behavior unchanged. Fixed: - Broken link from /contributing/agents/ to .cratis/PROJECT.md (private path). - Product documentation sync no longer ingests repository bootstrap files. Verified: - All existing tests pass. - New regression tests prove bootstrap exclusion at root and family sources. - Nested agents.md/claude.md/gemini.md pages remain in generated docs. - Link checker passes with 0 broken links (was 1). - Build completes successfully. - Private path protections remain intact.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Harden the documentation aggregator against silent Markdown/MDX and navigation failures across product repositories.
Changed
Fixed