Thank you for your interest in contributing! This project aims to make PhD-level concepts accessible to everyone.
- Open an issue with the concept name and why it's important
- Include the general theme (Statistics, Biology, Systems, etc.)
- Optionally suggest connections to existing concepts
- Fork the repository
- Create a new entry following the template in
/templates/entry-template.md - Ensure your entry follows these guidelines:
- 5-section format: Title, Kindergarten Explanation, Why It Matters, Connections, Quick Exercise
- Word count: 200-400 words total
- Tone: Curious and empowering, like explaining to a friend
- Analogies: Use everyday examples (toys, food, nature)
- Accuracy: Base on established science
- Run validation:
python scripts/validate_entry.py your-entry.md - Submit PR with clear description
Each entry must include:
- Concept Title: Clear and bold
- Kindergarten Explanation: Explain as if to a 5-year-old, start with the problem
- Why It Matters: One sentence on real-world impact
- Connections Unlocked: Link to 1-3 related concepts
- Quick Exercise: Simple prompt to apply the idea
- Simplicity: Short sentences, minimal jargon
- Depth: Show why it works, not just what it is
- Incremental: Build from problem → simple solution → refined insight
- Connections: Link to other entries to build the knowledge web
Before submitting:
- Entry follows 5-section format
- Word count is 200-400 words
- Analogies are clear and relatable
- Connections reference existing or planned concepts
- Tone is friendly and accessible
- Facts are accurate and sourced when needed
- File named correctly:
day-XXX-concept-title.md
Open an issue for clarification on guidelines or to discuss potential contributions.
By contributing, you agree that your contributions will be licensed under the MIT License.