Infrastructure That Documents Itself: A New Era for Developers and Platform Teams

Documentation is always the first thing to fall behind.

You ship a new Azure environment, wire up services, configure networking—and a few months later, nobody remembers why that Key Vault exists or how Container Apps talk to Cosmos DB.

We built a proof-of-concept repo to change that.

Using GitHub Copilot + Azure MCP (Model Context Protocol), this repo generates a complete infrastructure wiki directly from a live Azure environment in under 15 minutes—using only natural language prompts.

No manual writing. No portal copy-paste.

What You Get in Minutes

From a running Azure environment, the repo automatically generates:

• Architecture diagrams

• Full resource inventory (21 resources)

• Network topology

• Dependency maps

• Integration guides

• Operational runbooks

That’s 13 documentation files in ~15 minutes, with zero manual effort.

Join our community!

Why This Matters

Accurate by default

Docs reflect what’s actually deployed—not last quarter’s diagram.

Instant onboarding

New engineers get a real architecture walkthrough on day one.

Audit ready

Network and dependency documentation generated on demand.

Knowledge democratized

Junior engineers can produce senior-level documentation.

How It Works (High Level)

GitHub Copilot uses Azure MCP to query your live Azure environment:

• Discovers resources via Azure Resource Graph

• Inspects networking, security, and dependencies

• Generates diagrams and documentation automatically

You simply prompt in natural language.

Example:

“Create a wiki for this resource group with diagrams, inventory, dependencies, and runbooks.”

That’s it.

What’s Next

We’re scaling this into an Enterprise Documentation Agent using Azure AI Foundry:

• Multi-subscription discovery

• Automatic updates when infrastructure changes

• Pull requests with refreshed docs

• Compliance mapping

• Cost attribution

• Drift detection

The goal: always-current documentation across your entire Azure estate.

Try It Yourself

Repo: https://github.com/yourorg/genai_wiki

Requirements:

• GitHub Copilot

• Azure MCP extension

• Reader access to Azure

Works locally or via GitHub Codespaces.

Final Thoughts

Documentation doesn’t have to be manual or stale.

With the right tools, your infrastructure can document itself—accurately, instantly, continuously.

This repo shows what’s possible.

Author- Kevin Evans (Cloud Native Leader)