If needed, use separate pages when you need to explain:
  • System architecture, or how components interact
  • Business logic, formulas, or algorithms
  • Performance considerations or known limitations
  • Security design (e.g., encryption, RBAC model)
Keep the main guide focused. Move complex deep dives to child pages.