Complete AI Training

Prompt · Systems Administrators

Documenting Deployment Processes

Use this when you need to create or improve documentation for deploying applications across different environments.

All 11 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 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

  1. If any required context is missing, ask for it before proceeding.
  2. Create a step-by-step guide for deploying {{specific application}} to {{environments}}, including prerequisites, configuration, and verification steps.
  3. Document necessary configurations and dependencies for {{specific application}}.
  4. Outline best practices for documenting deployment processes across different environments, emphasizing consistency and clarity.
  5. 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?