Appendix: Navigation Patterns

Pattern 1: Flat (Small Spoke, <20 Pages)

* xref:index.adoc[Overview]
* xref:runbooks/switch-upgrade.adoc[Switch Upgrade]
* xref:runbooks/firewall-change.adoc[Firewall Change]
* xref:architecture/network-diagram.adoc[Network Diagram]
* xref:reference/vlan-table.adoc[VLAN Table]

Pattern 2: Grouped (Medium Spoke, 20-50 Pages)

* xref:index.adoc[Overview]
* Runbooks
** xref:runbooks/switch-upgrade.adoc[Switch Upgrade]
** xref:runbooks/firewall-change.adoc[Firewall Change]
** xref:runbooks/circuit-activation.adoc[Circuit Activation]
* Architecture
** xref:architecture/network-diagram.adoc[Network Topology]
** xref:architecture/vlan-design.adoc[VLAN Design]
** xref:architecture/ha-design.adoc[High Availability]
* Reference
** xref:reference/vlan-table.adoc[VLAN Table]
** xref:reference/ip-allocation.adoc[IP Allocation]
** xref:reference/port-standards.adoc[Port Standards]

Pattern 3: Modular Partials (Large Spoke, 50+ Pages)

Split the nav into partials — one per section:

File: nav.adoc

include::partial$nav/runbooks.adoc[]
include::partial$nav/architecture.adoc[]
include::partial$nav/reference.adoc[]
include::partial$nav/projects.adoc[]

File: partials/nav/runbooks.adoc

* Runbooks
** Switching
*** xref:runbooks/switch-upgrade.adoc[Switch Upgrade]
*** xref:runbooks/switch-replacement.adoc[Switch Replacement]
*** xref:runbooks/vlan-creation.adoc[VLAN Creation]
** Firewall
*** xref:runbooks/firewall-change.adoc[Firewall Change]
*** xref:runbooks/vpn-creation.adoc[VPN Tunnel Creation]
** Wireless
*** xref:runbooks/wlc-upgrade.adoc[WLC Upgrade]
*** xref:runbooks/ssid-creation.adoc[SSID Creation]

Each partial manages its own section. When the nav grows to 100+ pages, you edit the relevant partial — not a 500-line monolithic file.

Cross-Component Links in Nav

Link to pages in other spoke repos:

* Related
** xref:nac-ops::policies/dot1x.adoc[802.1X Policy (NAC Ops)]
** xref:security-ops::vpn/globalprotect.adoc[GlobalProtect VPN (Security)]