Docusaurus Site Organization for Junior Knowledge Base
1. Homepageβ
- Project overview: Vision, elevator pitch, and branding.
- Quick links: Onboarding, roadmap, architecture, team, etc.
2. Getting Started / Onboardingβ
- How to join/contribute
- Onboarding guide for new team members
- Prerequisites
- Setup instructions
- First tasks
3. Project Documentationβ
- High-Level Documents
- Overview & vision (z1)
- Phase-based plan (z3)
- Introductory PPT (z2) (link or embed)
- Roadmap & Milestones
- Current phase
- Upcoming features
- Release schedule
4. Architecture & Technical Docsβ
- System Architecture (z6)
- Tech stack overview
- Diagrams & component breakdown
- Integration plan
- Design Principles
- UI/UX standards
- AI/ML guidelines (if applicable)
- API Reference
5. Team & Rolesβ
- Roles & Responsibilities (z5)
- Org chart
- How to claim a role / onboarding for managers
6. Work Guideβ
- How to contribute docs/code
- Style guidelines
- PR process
- Issue templates
7. Recruiting / Externalβ
- Pitch deck (z2)
- Branding
- Slogans, vibes, and public positioning
8. FAQ & Troubleshootingβ
- Common issues
- Contact points
9. Changelog & Updatesβ
- Release notes
- Major decisions
10. References & Resourcesβ
- External links
- Further reading
- Related projects
Folder Structure Suggestionβ
/docs/
β Main content
/docs/onboarding/
/docs/overview/
/docs/roadmap/
/docs/architecture/
/docs/team/
/docs/Work/
/docs/recruiting/
/docs/faq/
/docs/changelog/
/docs/resources/
/static/
β Images, PPTs, diagrams, branding assets
/sidebars.js
β Organize navigation to match the above structure
- Use Markdown for all docs for ease of editing.
- Link issues (z1βz6) and tasks to relevant docs.
- Keep navigation cleanβprioritize onboarding and overview for new users.
- Use tags/categories for discoverability.