coding•6 prompts
Documentation Prompts
Good documentation makes code usable. These prompts help you create documentation that future developers (including you) will thank you for.
1. README Generator
Best: ClaudeWrite a README.md for this project: [describe project or paste code]. Include: Project title and description, installation instructions, usage examples with code, configuration options, contributing guidelines, and license. Make it scannable.
READMEs are often the first impression. Make setup instructions foolproof.
2. API Documentation
Best: ClaudeGenerate API documentation for these endpoints: [paste routes/handlers]. For each endpoint include: HTTP method and path, description, request parameters, request body schema, response schema, example request/response, and error codes.
Include actual working examples. Developers copy-paste from docs.
3. Function Documentation
Best: ClaudeWrite documentation for this function: [paste function]. Include: purpose, parameters with types and descriptions, return value, exceptions thrown, usage example, and edge cases to be aware of. Use [JSDoc/Python docstring/etc.] format.
Document why, not just what. The code shows what it does.
4. Architecture Documentation
Best: ClaudeDocument the architecture of this system: [describe or paste key code]. Create: high-level overview, component descriptions, data flow explanation, key design decisions and their rationale, and a diagram description (for Mermaid/PlantUML).
Architecture docs help onboarding. Explain the "why" behind structures.
5. Inline Comments
Best: ClaudeAdd inline comments to this code to explain complex logic: [paste code]. Don't comment obvious things. Focus on: why decisions were made, non-obvious side effects, performance considerations, and anything that confused you when writing it.
Comment the why, not the what. Bad: "increment i". Good: "skip header row".
6. Migration Guide
Best: ClaudeWrite a migration guide for users upgrading from [old version] to [new version]. Include: breaking changes, new features, step-by-step upgrade instructions, configuration changes needed, and common issues with solutions.
Migration guides reduce support burden. Be thorough about breaking changes.
Try These Prompts with Multiple AIs
Get responses from Claude, ChatGPT, Gemini, and more—all at once. Compare which AI handles these prompts best.
Try Council Free