Skip to content

Repository Map

Use this page when you want a quick map of the guide before diving into a specific section. It shows the major documentation areas, what each one is for, and a few fast paths for common reader goals.

Section Guide

Section Use When Start With
Start Here You need orientation, service-fit context, or a role-based way to begin reading. Overview
Platform You want to understand how Azure VMs work: lifecycle, disks, networking, identity, and availability. Platform Hub
Best Practices You are designing for production and want guardrails for sizing, security, monitoring, patching, and cost. Best Practices Hub
Operations You are running VMs day to day and need execution guidance for create, connect, patch, resize, backup, or monitor tasks. Operations Hub
Tutorials You want hands-on lab-style practice for high availability, security, Bastion, extensions, or disaster recovery. Tutorials Hub
Troubleshooting You are diagnosing an active issue such as boot failures, connectivity problems, or performance degradation. Troubleshooting Hub
Reference You need a quick lookup for VM sizes, disk types, availability options, networking components, or monitoring signals. Reference Hub
Contributing You are updating the guide itself and need repository standards, structure, or validation workflow details. Contributing

How the Guide Is Organized

  • Start Here answers, “Where should I begin?”
  • Platform explains core VM concepts and service behavior.
  • Best Practices turns those concepts into production design guidance.
  • Operations covers day-2 execution after a VM is deployed.
  • Tutorials give you reproducible labs to practice real tasks.
  • Troubleshooting helps you move from symptom to evidence to fix.
  • Reference is the quick-lookup layer for facts, tables, and terminology.

Reader Journeys

I'm new to Azure Virtual Machines

  1. Read Overview.
  2. Read Learning Paths.
  3. Read VM vs Other Compute.
  4. Continue to the Platform Hub.

I'm planning a production VM deployment

  1. Start at Scenario Router.
  2. Review the Platform Hub for sizing, disks, networking, and availability.
  3. Move to the Best Practices Hub for production baseline decisions.
  4. Use the Reference Hub for supporting limits and comparison tables.

I'm operating VMs in production

  1. Start at the Operations Hub.
  2. Use the Best Practices Hub to validate your production baseline.
  3. Keep the Reference Hub handy for quick lookups.

I'm responding to an incident

  1. Open the Troubleshooting Hub.
  2. If needed, jump to First 10 Minutes.
  3. Follow the relevant playbook or use Quick Diagnosis Cards.
  4. Return to Operations or Best Practices to harden the environment after recovery.

See Also

Sources