Repository Map¶

The Azure Networking Practical Guide is organized to mirror the workflow of designing, operating, and troubleshooting Azure network connectivity. This page explains the structure and purpose of each section so you can jump directly to what you need.

mermaid graph TD Root[docs/] --> Start[start-here/] Root --> Platform[platform/] Root --> BP[best-practices/] Root --> Ops[operations/] Root --> Tut[tutorials/] Root --> Trouble[troubleshooting/] Root --> Ref[reference/]

Directory Structure¶

• docs/start-here/
  • overview.md: Big-picture introduction to Azure networking topology and this guide.
  • learning-paths.md: Role-based reading paths for network engineers, platform teams, and app owners.
  • repository-map.md: This file — a map of major sections and when to use them.
  • networking-vs-connectivity.md: How to frame networking problems as connectivity problems.
  • scenario-router.md: Situation-to-destination router across Plan, Deploy, Operate, and Troubleshoot phases.
• docs/platform/
  • Core concepts: VNet, subnets, IP addressing, DNS, routing, network security, load balancing, private and hybrid connectivity.
• docs/best-practices/
  • Production patterns: network design baseline, subnet design, DNS, routing, NSG and firewall, private endpoints, observability, cost awareness, anti-patterns.
• docs/operations/
  • Day-2 execution: create VNets and subnets, configure NSG/DNS/UDR, connect private endpoints, peering, VPN and ExpressRoute basics, monitor network paths, packet capture.
• docs/tutorials/
  • Hands-on lab guides: hub-spoke topology, private endpoints, Application Gateway WAF, Azure Firewall, ExpressRoute simulation.
• docs/troubleshooting/
  • Diagnosis-first content: architecture overview, decision tree, evidence map, mental model, quick diagnosis cards, first-10-minutes runbooks, and playbooks for connectivity, DNS, and routing.
• docs/reference/
  • Quick-lookup material: connectivity decision guide, networking components, DNS and routing cheatsheets, private connectivity options, glossary, and content validation status.

When to Use Each Section¶

See Also¶

• Overview
• Learning Paths
• Networking vs Connectivity
• Scenario Router

Sources¶

• Azure Virtual Network Documentation
• Azure Virtual Network Concepts
• Cloud Adoption Framework — Network Topology and Connectivity