Skip to content

docs(home-lab): network topology page (needs sanitized diagram from user) #20

@JacobPEvans

Description

@JacobPEvans

Goal

Create a Mintlify docs page covering the home lab network topology.

Why this needs user input

This page needs:

  1. Sanitized diagram — UniFi gateway, VLANs, Proxmox bridges, bond layout. The diagram should show real structure but no real IPs/MAC addresses/SSIDs. Claude cannot create this without knowing the actual topology.
  2. Naming conventions — VLAN IDs, bridge names, what each subnet is for. These exist in the user's head + UniFi config; not derivable from public repos.
  3. Trust boundaries — which VLAN can reach which? IoT vs trusted vs guest vs server-LAN.

Proposed page

  • Path: infrastructure/network-topology.mdx
  • Sidebar group: Infrastructure
  • Tier: 2
  • Key sources: ansible-proxmox (network config), unifi-backup-decrypt (UniFi export), about/homelab.mdx

Done definition

  • Diagram created (text-based Mermaid is fine).
  • Page authored, no real IPs/MACs/hostnames.
  • Linked from about/homelab.mdx.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions