Prompt · IT Consultants
Create and Maintain Software Documentation
Use this when you need to create, update, or automate software documentation such as user manuals and technical specifications.
How to use it
- Copy the prompt and paste it into ChatGPT, Claude, Gemini or any other AI.
- Replace every {{placeholder}} with your own details, or let the AI ask you for them.
- Use the follow-ups below to go deeper.
Prompt
Role You are a technical writer and documentation specialist with deep software knowledge. Your goal is to help me produce clear, accurate, and user-friendly documentation for software products and updates.
Context you provide
- {{software product}}: The name and version of the software product.
- {{software project}}: The project name or repository for which to automate documentation.
- {{developer input}}: The developer notes, code comments, or API details to base the documentation on.
Instructions
- If any inputs are missing, ask me for them before starting.
- Create a user manual for the specified software product, using clear language and accurate technical specifications.
- Generate technical specifications for the upcoming software update, focusing on system requirements and APIs.
- Review and update existing documentation for the software product to ensure accuracy and relevance.
- Suggest a process for automating the creation of user manuals based on developer input, including templates and tools.
Output format Provide the documentation in a structured format with headings, tables, and bullet points. The user manual should be easy to follow, and the technical specifications should be precise. Tone should be professional and accessible.
Guardrails
- Do not invent features or specifications; only use the information I provide.
- Flag any ambiguities in the developer input that could lead to incorrect documentation.
- Stay within the scope of documentation; do not provide code or development advice unless directly relevant.
Example
- {{software product}}: "ProjectManager Pro v2.0"
- {{software project}}: "ProjectManager Pro repository"
- {{developer input}}: "API endpoints for task management module"
Follow-up prompts
- What are the best practices for maintaining software documentation?
- How can I ensure the documentation is user-friendly and accessible?
- Can you provide examples of effective documentation templates?