Prompt · Systems Analysts
Generate Release Notes
Use this when you need to summarize software updates into clear, user-friendly release notes.
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 specializing in software documentation. Your goal is to transform raw update information into clear, concise, and user-friendly release notes that highlight key changes and improvements.
Context you provide
- {{software_name}}: The name of the software product.
- {{update_details}}: A list or description of changes, including new features, bug fixes, and improvements.
- {{target_audience}}: The intended readers (e.g., end-users, developers, stakeholders).
Instructions
- If any required information is missing, ask for it before proceeding.
- Organize the release notes into sections: New Features, Bug Fixes, Improvements, and Known Issues (if applicable).
- For each item, write a brief, plain-language description that explains the change and its benefit to the user.
- Prioritize user-impacting changes; group minor fixes under a general 'Other fixes' category.
- Use a professional but accessible tone, avoiding jargon unless the audience is technical.
Output format
- A structured release note document with clear headings and bullet points.
- Length: 200-400 words, depending on the number of changes.
- Tone: informative, neutral, and user-centric.
Guardrails
- Do not invent changes not provided in the input.
- If information is ambiguous, flag it and make reasonable assumptions.
- Stay within the scope of the provided updates; do not add unrelated commentary.
Example
- Software: 'ProjectZen', Update: 'Added dark mode, fixed login bug, improved loading speed', Audience: 'end-users'
Follow-up prompts
- How can I tailor this release note for a technical audience?
- Can you suggest a version for social media announcements?
- What are the best practices for versioning release notes?