Skip to content

Navigation Guide

How to Find What You Need in Mobius Systems Documentation

Version: 1.0.0
Last Updated: 2025-11-26


Quick Start

New to Mobius?

πŸ‘‰ Start Here: 01-INTRODUCTION/00-START-HERE.md

Looking for Something Specific?

πŸ” Use the Master Index: MASTER_INDEX.md

Browsing by Topic?

πŸ“š Use the Subject Index: SUBJECT_INDEX.md


1. By Classification (Structure-Based)

Use the classification number to navigate directly:

000 - Want to understand the documentation system?
      β†’ /docs/00-META/

100 - New user, need introduction?
      β†’ /docs/01-INTRODUCTION/

200 - Interested in philosophy and theory?
      β†’ /docs/02-THEORETICAL-FOUNDATIONS/

300 - Need governance and policy information?
      β†’ /docs/03-GOVERNANCE-AND-POLICY/

400 - Looking for technical architecture?
      β†’ /docs/04-TECHNICAL-ARCHITECTURE/

500 - Need implementation guides?
      β†’ /docs/05-IMPLEMENTATION/

600 - Looking for operations procedures?
      β†’ /docs/06-OPERATIONS/

700 - Want research and publications?
      β†’ /docs/07-RESEARCH-AND-PUBLICATIONS/

800 - Need API or reference docs?
      β†’ /docs/08-REFERENCE/

900 - Looking for supporting materials?
      β†’ /docs/09-APPENDICES/ or /docs/10-ARCHIVES/

2. By Role (Purpose-Based)

I'm a New User
  1. START-HERE
  2. Handbook
  3. Quick Reference
I'm a Developer
  1. Technical Architecture
  2. Implementation Guides
  3. API Reference
I'm a Researcher
  1. Whitepapers
  2. Theoretical Foundations
  3. Research Publications
I'm an Operator
  1. Operations
  2. Deployment Guides
  3. Runbooks
I'm Interested in Governance
  1. Governance Overview
  2. Constitution
  3. Policy

3. By Topic (Content-Based)

Use the Subject Index to find all documents related to a topic.

Example Topics: - DVA β†’ See Subject Index under "D" - MIC Economics β†’ See Subject Index under "M" - Governance β†’ See Subject Index under "G" - APIs β†’ See Subject Index under "A"

4. By Document Name (Alphabetical)

Use the Master Index - Alphabetical Section to find documents by name.

5. By Document ID (Citation-Based)

All major documents have a Doc ID (e.g., WP-2025-001).

Find documents by ID in the Master Index.


Search Strategies

  1. Open Subject Index
  2. Search (Ctrl+F / Cmd+F) for your keyword
  3. Follow links to relevant documents

Strategy 2: Browse by Category

  1. Choose your classification (000-900)
  2. Read category README
  3. Navigate to specific documents

Strategy 3: Cross-Reference Navigation

  1. Start with a known document
  2. Look for "See also" or "Related Documentation" sections
  3. Follow cross-references to related content
  1. Start with Master Index
  2. Use browser search (Ctrl+F / Cmd+F)
  3. Search by title, Doc ID, or topic

Common Searches

"Where is the MIC whitepaper?"

πŸ“„ Answer: 07-RESEARCH-AND-PUBLICATIONS/whitepapers/MIC_Whitepaper_v2.1.md
Doc ID: WP-2025-001

"How do I deploy Mobius?"

πŸš€ Answer: 05-IMPLEMENTATION/guides/deployment/DEPLOYMENT_GUIDE.md
Doc ID: DEPLOY-2025-001

"What is DVA?"

πŸ” Answer: 04-TECHNICAL-ARCHITECTURE/dva/
Doc ID: DVA-2025-001

"How is Mobius governed?"

πŸ›οΈ Answer: 03-GOVERNANCE-AND-POLICY/governance/overview.md
Doc ID: GOV-2025-001

"Where are the API docs?"

πŸ”Œ Answer: 08-REFERENCE/api/
Doc ID: API-2025-001


Tips & Tricks

Tip 1: Use README Files

Every major category has a README with: - Overview of the category - Contents and structure - Key documents highlighted - Cross-references

Always start with the README when exploring a new category.

Tip 2: Follow the Trail

Documents include cross-references like: - "See also: β†’ [Other Topic]" - "Related Documentation:" - "For more details, see [@DOC-ID]"

Follow these links to discover related content.

Tip 3: Bookmark Key Pages

Create bookmarks for frequently used pages: - Master Index - Your role's starting point - Favorite documents

Tip 4: Use Doc IDs for Citations

When citing or referencing: - Use the Doc ID (e.g., WP-2025-001) - Provides stable reference even if file moves - Makes collaboration easier

Tip 5: Check Last Updated

Documents show Last Updated date in frontmatter. - Ensures you're reading current information - Helps track document freshness


Document Hierarchy

Understanding the Structure

Category (00-10)
  └─ Subcategory
      └─ Topic Area
          └─ Individual Documents

Example:

04-TECHNICAL-ARCHITECTURE/      (Category)
  └─ dva/                       (Subcategory)
      └─ DVA_MEMT_INTEGRATION.md (Document)

Maximum Depth: 3 Levels

  • Never more than 3 clicks to reach a document
  • Ensures fast navigation
  • Reduces cognitive load

Mobile & Offline

Mobile Navigation

  • Use table of contents in long documents
  • Bookmark key pages
  • Master Index works well on mobile

Offline Access

  • Clone the repository for offline access
  • All documentation is in markdown (readable offline)
  • No external dependencies for core docs

Need Help?

Can't Find What You Need?

  1. Check Master Index - most comprehensive
  2. Try Subject Index - topic-based
  3. Search GitHub repository
  4. Ask in GitHub Discussions

Want to Improve Documentation?


Quick Reference Card

I Want To... Go To...
Get started START-HERE
Find any document Master Index
Browse by topic Subject Index
Learn architecture Technical Architecture
Deploy system Deployment Guides
Understand economics MIC Whitepaper
Read governance Governance Overview
Access APIs API Reference
Find runbooks Operations
Read research Research & Publications

Version Information

  • Version: 1.0.0
  • Last Updated: 2025-11-26
  • Next Review: 2025-12-26
  • Status: Published

Classification: 000 - Meta-Documentation
Status: Published
License: CC-BY-SA-4.0
Document ID: NAV-2025-001

"Good documentation is invisible infrastructure. You shouldn't need to think about navigationβ€”you should just find what you need."