Skip to content

Readme

Ah, brave adventurer! You've reached the mystical realm of IT knowledge — where code flows like magic, systems rise like castles, and every bug is but a dragon to be slain.

Use the Tier Map, class paths, and Browse All Quests above to chart your journey. The references below help you go deeper, get set up, and contribute back to the realm.

Codex & Reference

Getting Started

For Complete Beginners

  1. Prerequisites check: Do you have a GitHub account?
  2. Yes → Log in to GitHub
  3. No → Sign up for GitHub
  4. Fork the repository: Fork it-journey
  5. Choose your first quest: Start at the 0000 Foundation & Init World hub and pick a quest from its grid.

For Experienced Adventurers

  1. Explore the World Map for orientation.
  2. Assess your level using the Tier Map above (or the full level reference under How Progression Works) and jump straight to the matching hub.
  3. Pick a specialization from the class paths and follow its level chain.

Contributing to the Quest Realm

Every great wizard started as an apprentice, and every master was once a beginner.

This collection grows through community contributions — typo fixes, new quests, or your own learning journey:

  1. Fork the repository.
  2. Branch your changes (feature/new-quest or fix/typo-correction).
  3. Create content following the quest template.
  4. Document your changes in the appropriate level directory.
  5. Submit a pull request with a clear description.

Quest Writing Guidelines

  • Maintain the fantasy theme — use gaming and magical metaphors.
  • Include learning objectives — clear goals for each quest.
  • Provide practical examples — real code, commands, and configuration.
  • Use the canonical taxonomy — a valid level (0000–1111), one of the four difficulties (🟢 Easy / 🟡 Medium / 🔴 Hard / ⚔️ Epic), and the required frontmatter fields. The validator and quest_registry.py enforce this.
  • Cross-reference related quests — link to level hubs (/quests/{code}/) to build learning paths.
  • Test your instructions — ensure every step works as described.

Support & Community

Stuck on a quest?

  • 📖 Check the Glossary for term definitions.
  • 🗺️ Consult the World Map for navigation.
  • 💬 Join community discussions via Giscus comments.
  • 🐛 Report issues or suggest improvements via GitHub Issues.

Remember, brave adventurer: every great wizard started as an apprentice. Mistakes are like misfired spells — you learn from them. Ready your wand (keyboard), and off you go! 🌟💻📚

May your code compile and your deployments be ever successful! ⚡✨