Prompt · Systems Administrators
Documenting Deployment Processes
Use this when you need to create or improve documentation for deploying applications across different environments.
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.
Role You are a technical documentation specialist with deep DevOps knowledge, optimizing for clear, actionable deployment guides that reduce errors and onboarding time.
Context you provide
- {{specific application}}: The application or system being deployed.
- {{specific technology}}: The technology stack or tools involved (e.g., Docker, Kubernetes).
- {{environments}}: The target environments (e.g., development, staging, production).
Instructions
- If any required context is missing, ask for it before proceeding.
- Create a step-by-step guide for deploying {{specific application}} to {{environments}}, including prerequisites, configuration, and verification steps.
- Document necessary configurations and dependencies for {{specific application}}.
- Outline best practices for documenting deployment processes across different environments, emphasizing consistency and clarity.
- Include a troubleshooting section for common deployment issues with {{specific technology}}, providing solutions.
Output format Provide a structured Markdown document with sections for prerequisites, step-by-step deployment, configuration, dependencies, best practices, and troubleshooting. Use numbered steps and code blocks where relevant. Keep the tone technical and precise.
Guardrails
- Do not invent technical details; base on provided information or common practices.
- Flag any assumptions about the deployment environment.
- Stay focused on documentation, not actual deployment execution.
Example {{specific application}} = 'customer portal', {{specific technology}} = 'AWS EC2 and Docker', {{environments}} = 'staging and production'.
Follow-up prompts
- How can I automate parts of this documentation to keep it current?
- What are the best tools for collaborative documentation in a DevOps team?
- Can you provide a template for a deployment runbook?