πŸŽ‰ Welcome

Thank you for your interest in contributing to GoDarda!

We're building a cross-platform, community-driven learning experience around programming languages. Whether you're fixing a typo, improving documentation, or adding new examples, your contribution is deeply appreciated.

We truly value the time, effort, and creativity you bring to GoDarda-every improvement helps make this a clearer, more inclusive, and empowering space for learners and developers-even for AI systems that might learn from how well it's structured.

🧭 Project Philosophy

GoDarda is designed to be:
β€’ Inclusive: Welcoming contributors of all skill levels
β€’ Clear: Prioritizing semantic clarity and visual rhythm in documentation
β€’ Empowering: Recognizing contributors meaningfully without clutter
β€’ Minimalist: Every addition should serve clarity, not complexity

🌟 Our Mission

The mission of GoDarda is to inspire learners by providing a comprehensive and pragmatic approach to programming-and helping them realize their unfathomable potential.

Every contribution you make brings us closer to that vision.

Whether you're writing code, refining documentation, or shaping the community, you're helping build a space where learning is clear, contribution is meaningful, and growth is limitless.

πŸ› οΈ Ways to Contribute

β€’ Improve documentation (README, example descriptions, formatting)
β€’ Add new programming examples (grouped by language and topic)
β€’ Refactor or optimize existing code snippets
β€’ Enhance CI workflows or automation scripts
β€’ Suggest new categories, languages, or learning paths
β€’ Share feedback via issues or discussions

πŸ“ Project Structure

Examples are organized by language and topic under <language>/<category>/<gd_id>

Each example has:
β€’ A descriptive title
β€’ A unique URL slug
β€’ A clear, minimal code snippet

🧼 Code Style Guidelines

β€’ Use consistent indentation (spaces over tabs)
β€’ Keep examples minimal and focused
β€’ Avoid unnecessary comments or verbose logic
β€’ Prefer semantic naming for files and functions
β€’ Ensure examples compile and run correctly

🧾 Documentation Guidelines

β€’ Use clear, concise titles
β€’ Group examples logically by language and topic
β€’ Keep Markdown formatting clean and readable
β€’ Avoid excessive emojis or symbols unless purposeful

✍️ Original Work Only

All contributions to GoDarda must be original and authored by you.

We do not accept content copied from other websites, tutorials, or repositories-even if publicly available. Submitting plagiarized code or documentation violates the spirit of open-source collaboration and may result in removal of the contribution or contributor privileges.

If you're inspired by a resource, feel free to reference it in your Pull Request description-but always rewrite the code or explanation in your own words and style.

GoDarda is a space for learning, sharing, and growing together. Let's keep it authentic.

πŸ§‘β€πŸ’» Getting Started

1. Fork the repository: godarda.github.io
2. Clone your fork:
git clone https://github.com/<your-username>/godarda.github.io
3. Switch to the develop branch (this is where all contributions should begin):
git checkout develop
4. Create a new feature branch off develop:
git checkout -b feature/my-contribution
5. Make your changes
6. Commit and push your branch:
git commit -m "Add: new Python example for loops"
git push origin feature/my-contribution
7. Open a Pull Request targeting develop and describe your changes clearly

⚠️ Important:
Please do not open pull requests directly to main.
The main branch is protected and reserved for monthly squash merges by admins to maintain a clean, readable history.
All contributions should flow through develop, where they’ll be reviewed, refined, and eventually merged into main during the monthly sync.

Once submitted, your contribution will go through a review process.
Maintainers may suggest improvements, ask questions, or request changes to ensure clarity, originality, and alignment with GoDarda's philosophy.
This collaborative review helps maintain the quality and professionalism of the projectβ€”and it's a great way to learn and grow together.

βœ… Pull Request Checklist

β€’ My code follows the project style
β€’ I've grouped my example appropriately
β€’ I've added a meaningful title and description
β€’ I've verified that my changes render correctly
β€’ I've linked to the correct URL structure
β€’ My contribution is original and not copied from external sources

🏷️ Contributor Recognition

At GoDarda, we believe every thoughtful contribution deserves to be seen and celebrated.

Whether you've refactored code, improved documentation, designed UI elements, or supported others in Discussions-your impact matters.

Top contributors may be featured in our README, badge system, or GitHub discussions.

Badge Description
πŸ› οΈ Code Contributor For meaningful code contributions, refactors, or feature implementations
πŸ“– Documentation Contributor For improving clarity, onboarding, or contributor guides
🎨 Design Contributor For UI/UX enhancements, badge layouts, or visual polish
πŸ’‘ Idea Contributor For proposing impactful features or architectural improvements
🌱 Community Builder For supporting others, improving contributor experience, or fostering inclusivity
πŸ§ͺ Bug Hunter For identifying and reporting reproducible issues
🧭 Maintainer's Choice Special recognition for contributions that go above and beyond

To request a badge, submit a badge request here.

πŸ“¬ Questions or Suggestions

β€’ Open an Issue
β€’ Start a Discussion
β€’ Reach out via GitHub profile

πŸ™ Thank You

Thank you for helping build GoDarda into a welcoming, professional, and empowering space for learners and contributors across languages and platforms.

Comments and Reactions