documentation-patterns

Standardize project documentation with structured patterns and reusable templates.

9|5|Updated Aug 8, 2025
One-click install
npx skills add https://github.com/AnExiledDev/CodeForge --skill documentation-patterns-anexileddev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation-patterns
Source: https://github.com/AnExiledDev/CodeForge/tree/main/.devcontainer/plugins/devs-marketplace/plugins/code-directive/skills/documentation-patterns
Command: npx skills add https://github.com/AnExiledDev/CodeForge --skill documentation-patterns-anexileddev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Documentation has audiences. README for new users, API docs for integrators, architecture docs for maintainers, inline docs for contributors. Wrong audience = wrong documentation. Before writing, identify who will read it and what they need to accomplish.

Core Features & Use Cases

  • Audience determines format. A README walks someone through getting started. An API reference lists every parameter with types. An architecture doc explains why decisions were made. Don't mix formats.
  • Code is the source of truth. Never copy code into documentation — reference file paths instead. Copied snippets rot as soon as the source changes.
  • Concise, specific, active voice. "Returns a list of users" not "A list of users is returned by this function." Cut filler words entirely.
  • Show, don't tell. A working example communicates more than three paragraphs of explanation.
  • Documentation Types: README, API Reference, Architecture, Inline Documentation, Changelog, Configuration.

Quick Start

Draft a documentation pattern set that covers the most common doc types (README, API reference, architecture) and cite the references as templates.

Frequently Asked Questions about documentation-patterns

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I standardize README generation and API reference formats across a software project?

Standardize README and API documentation by applying audience-aware templates that enforce specific formatting rules. The Skill provides reusable patterns in its references directory to guide authors in structuring content for the correct reader type.

What's the best way to keep code snippets in architecture documentation from getting outdated?

Keep architecture documentation accurate by referencing file paths instead of copying code snippets directly. Copied code rots when the source changes, so the Skill enforces patterns that treat the codebase as the single source of truth.

When do I need to use different documentation patterns for my project?

You need different documentation patterns when targeting distinct audiences like new users, integrators, and maintainers. The Skill defines problem-focused sections for READMEs, API references, and architecture docs to prevent mixing formats.

How do I write concise inline docstrings that follow standard architecture patterns?

Write concise inline docstrings using active voice and specific, problem-focused templates. The Skill enforces patterns that cut filler words and provide working examples rather than lengthy explanations for contributors.

Can I use these documentation templates for an existing software project with mixed formats?

Yes, you can apply these documentation templates to existing projects. The Skill provides structured patterns for READMEs, API references, architecture docs, and inline docs to standardize mixed formats into an audience-aware structure.