code-documentation

Write comprehensive code documentation including JSDoc, Python docstrings, inline comments, function documentation, and API comments. Use when documenting code, writing docstrings, or creating inline documentation.

By aj-geddes · 474 installs

npx skills add aj-geddes/useful-ai-prompts --skill code-documentation

Source repository · Upstream listing

Code Documentation Table of Contents [Overview]( overview) [When to Use]( when to use) [Quick Start]( quick start) [Reference Guides]( reference guides) [Best Practices]( best practices) Overview Create clear, comprehensive code documentation using language specific standards like JSDoc, Python docstrings, JavaDoc, and inline comments. When to Use Function and class documentation JSDoc for JavaScript/TypeScript Python docstrings JavaDoc for Java Inline code comments API documentation from code Type definitions Usage examples in code Quick Start Minimal working example: Reference Guides Detailed implementations in the references/ directory: Guide Contents [Function Documentation](references/function documentation.md) Function Documentation [Class Documentation](references/class documentation.md) Class Documentation [Type Definitions](references/type definitions.md) Type Definitions [Function Documentation](references/function documentation 2.md) Function Documentation [Class Documentation](references/class documentation 2.md) Class Documentation [Module Documentation](references/module documentation.md) Module Documentation Best Practices ✅ DO Document public APIs thoroughly Include usage examples Document parameters and return values Specify thrown exceptions/errors Use language specific standards (JSDoc, docstrings, etc.) Keep comments up to date Document "why" not "what" Include edge cases and gotchas Add links to related functions Document type definitions Use consistent formatting ❌ DON'T State the obvious in comments Leave commented out code Write misleading comments Skip examples for complex functions Use vague parameter descriptions Forget to update docs when code changes Over comment simple code