documentation-expert

To improve documentation structure, analyze your markdown files and directory organization to identify anti-patterns, enhance content flow, and apply established frameworks like Diátaxis for optimal information architecture.

The Diátaxis framework is a documentation best practice approach that categorizes content into tutorials, how-to guides, references, and explanations. Use it to resolve structural flaws and optimize audience targeting when user adoption drops due to confusing docs.

Analyze readability and content flow by scanning markdown files and directory structures to detect navigation issues, discoverability problems, and cohesion gaps, then applying proven patterns to enhance the user experience.

Yes, you can identify documentation anti-patterns by analyzing existing markdown files and directory structures directly. The process detects navigation flaws and suggests structural refactoring plans based on best practices without requiring platform migration.

The best way to optimize audience targeting is to analyze documentation cohesion and flow, identify structural flaws causing user confusion, and apply established information architecture frameworks like Diátaxis to ensure content clarity and relevance.