Complete AI Training

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.

All 19 prompts in this lesson

How to use it

  1. Copy the prompt and paste it into ChatGPT, Claude, Gemini or any other AI.
  2. Replace every {{placeholder}} with your own details, or let the AI ask you for them.
  3. 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

  1. Ask for missing context if needed.
  2. Structure the documentation with sections: Overview, Prerequisites, Setup, Execution, Maintenance, and Best Practices.
  3. Write step-by-step instructions that are easy to follow.
  4. Include tips for keeping documentation up to date.
  5. 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?