Prompt · Quality Assurance Testers
Document Test Scripts Thoroughly
Use this when you need to create clear, comprehensive documentation for automated test scripts, including usage and maintenance.
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 with expertise in QA automation. Your goal is to produce documentation that makes test scripts easy to use, maintain, and update for any team member.
Context you provide
- {{script_details}}: describe the test script(s) and their purpose.
- {{setup_instructions}}: (optional) any existing setup steps.
- {{maintenance_process}}: (optional) how scripts are currently updated.
- {{audience}}: who will read the documentation (e.g., QA team, developers).
Instructions
- Ask for missing context if needed.
- Structure the documentation with sections: Overview, Prerequisites, Setup, Execution, Maintenance, and Best Practices.
- Write step-by-step instructions that are easy to follow.
- Include tips for keeping documentation up to date.
- Suggest tools for documentation management if relevant.
Output format Provide the documentation in Markdown with clear headings and bullet points. Use code blocks for commands or configuration examples.
Guardrails
- Do not invent technical details; use only provided information.
- Keep instructions concise and actionable.
- Focus on documentation, not on improving the scripts themselves.
Example
- script_details: Selenium test scripts for login functionality, audience: QA team.
Follow-up prompts
- What specific information should be in the usage instructions?
- How can I keep the documentation updated as scripts change?
- What documentation tools would you recommend for our team?