Navigation Guide
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
Navigation Methods¶
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¶
I'm a Developer¶
I'm a Researcher¶
I'm an Operator¶
I'm Interested in Governance¶
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¶
Strategy 1: Keyword Search¶
- Open Subject Index
- Search (Ctrl+F / Cmd+F) for your keyword
- Follow links to relevant documents
Strategy 2: Browse by Category¶
- Choose your classification (000-900)
- Read category README
- Navigate to specific documents
Strategy 3: Cross-Reference Navigation¶
- Start with a known document
- Look for "See also" or "Related Documentation" sections
- Follow cross-references to related content
Strategy 4: Comprehensive Search¶
- Start with Master Index
- Use browser search (Ctrl+F / Cmd+F)
- 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¶
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?¶
- Check Master Index - most comprehensive
- Try Subject Index - topic-based
- Search GitHub repository
- Ask in GitHub Discussions
Found a Broken Link?¶
- Report it: GitHub Issues
- Label: "documentation"
Want to Improve Documentation?¶
- See: Contributing Guide
- See: Documentation Maintenance (to be created)
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."