write-documentation-guide

What problem does it solve?

BookStore teams often struggle with keeping documentation consistent, up-to-date, and properly cross-referenced. This skill enforces a standardized process to create DocFX-ready guides that align with project conventions, reducing duplication and onboarding friction.

Core Features & Use Cases

• Enforces a consistent guide structure aligned with BookStore conventions.
• Integrates with DocFX templates and navigation.
• Supports creating new guides and updating existing ones.
• Use Case: When adding API, architectural, or operator guides, generate a DocFX-ready document scaffold.

Quick Start

Create a new guide in docs/guides/{topic-name}-guide.md using templates/guide-template.md, then update docs/toc.yml and build the DocFX site to verify navigation and formatting.