Social Winter of Code (SWOC) is a winter-long open-source program that mentors students through meaningful, real-world contributions.
Your ultimate beginner-friendly guide to open source.
No jargon. No confusion. Just clear steps to help you start contributing with confidence.
Think of this as your friendly roadmap into open source 🌱
- Simplify Git & GitHub for beginners
- Explain real-world open-source workflows
- Share curated learning resources
- Prepare contributors for SWOC, GSSoC, GSoC & Hacktoberfest
- Foster an inclusive & welcoming community
| Feature | Description | Benefit |
|---|---|---|
| 🔰 Beginner Guides | Step-by-step Git & GitHub tutorials | Build confidence from scratch |
| 🚀 Quick Start | Setup guide in under 5 minutes | Start contributing immediately |
| 🎓 Program Info | Roadmap for GSoC, SWOC, GSSoC | Find your next big opportunity |
| 🤝 Supportive Community | Peer support and mentor reviews | Never get stuck alone |
OPENSOURCE-COMPASS/
├── .github/
│ ├── ISSUE_TEMPLATE/
│ │ ├── bug_report.yml
│ │ ├── documentation_update.yml
│ │ ├── feature_request.yml
│ │ ├── guide_proposal.yml
│ │ └── program_addition.yml
│ ├── workflows/
│ │ ├── issue-auto-comment.yml
│ │ ├── jekyll-gh-pages.yml
│ │ ├── pr-review.yml
│ │ └── static.yml
│ └── PULL_REQUEST_TEMPLATE.md
├── .vscode/
│ └── settings.json
├── backend/
│ ├── config/
│ │ └── db.js
│ ├── controllers/
│ │ ├── authController.js
│ │ └── contributorProgressController.js
│ ├── middleware/
│ │ └── authMiddleware.js
│ ├── models/
│ │ └── User.js
│ ├── routes/
│ │ ├── authRoutes.js
│ │ └── contributorProgressRoutes.js
│ ├── .gitignore
│ ├── package-lock.json
│ ├── package.json
│ └── server.js
├── frontend/
│ ├── assets/templates/
│ │ ├── contributing.md
│ │ ├── issue-template.md
│ │ ├── pr-template.md
│ │ └── readme.md
│ ├── css/
│ │ ├── auth.css
│ │ ├── beginners-guide.css
│ │ ├── chatbot.css
│ │ ├── contribute.css
│ │ ├── contributors.css
│ │ ├── guides.css
│ │ ├── home.css
│ │ ├── navigation.css
│ │ ├── pdf_guide.css
│ │ ├── program.css
│ │ ├── resources.css
│ │ ├── sitemap.css
│ │ └── style.css
│ ├── data/
│ │ ├── chatbot_data.json
│ │ ├── programs.json
│ │ └── quiz_data.json
│ ├── js/
│ │ ├── auth.js
│ │ ├── chatbot.js
│ │ ├── components.js
│ │ ├── contribute.js
│ │ ├── contributors.js
│ │ ├── guides.js
│ │ ├── home.js
│ │ ├── main.js
│ │ ├── profile.js
│ │ ├── profile2.js
│ │ ├── programs-page.js
│ │ ├── programs.js
│ │ ├── resources.js
│ │ ├── search.js
│ │ ├── sitemap.js
│ │ └── theme.js
│ ├── library/
│ │ ├── assets/
│ │ └── guides_pdf/
│ │ ├── GSoC.pdf
│ │ ├── GSSOC.pdf
│ │ ├── Hacktoberfest.pdf
│ │ ├── LFX Mentorship.pdf
│ │ ├── Outreachy.pdf
│ │ └── SSoC.pdf
│ ├── pages/
│ │ ├── Event/
│ │ │ ├── gsoc.html
│ │ │ ├── gssoc.html
│ │ │ ├── hacktober.html
│ │ │ ├── linux.html
│ │ │ ├── outreachy.html
│ │ │ └── ssoc.html
│ │ └── guides/
│ │ ├── ethics-licensing.html
│ │ ├── Contribute.html
│ │ ├── contributors.html
│ │ ├── faq.html
│ │ ├── glossary.html
│ │ ├── guides.html
│ │ ├── pdf_guide.html
│ │ ├── profile.html
│ │ ├── programs.html
│ │ ├── Resources.html
│ │ └── sitemap.html
│ └── node_modules/
├── public/
├── .stylelintrc.json
├── 404.html
├── CODE_OF_CONDUCT.md
├── CONTRIBUTING.md
├── index.html
├── LICENSE
├── package-lock.json
└── README.md
| Name | Role | GitHub | |
|---|---|---|---|
| Sayee Gosavi | Project Admin | @sayeeg-11 | https://linkedin.com/in/sayee-gosavi11 |
Responsible for project direction, reviews, and overall quality.
| Name | Role | GitHub | |
|---|---|---|---|
| Sameera Jape | Mentor | @sameera731 | https://linkedin.com/in/sameera-jape |
| Satyam Pandey | Mentor | @Satyam12x | https://linkedin.com/in/satyam-pandey-301061272 |
| Gopichand | Mentor | @Gooichand | https://linkedin.com/in/gopichand-d-269709287 |
Mentors guide contributors, review pull requests, and provide feedback throughout SWOC’26.
Thanks to these amazing people who have contributed to OpenSource Compass ✨
- Browse the Issues section
- Comment on the issue you want to work on
- Wait for assignment
- Create a new branch
- Make your changes
- Open a Pull Request
📌 Important Rules
- Do not create a PR without issue assignment
- Keep changes focused and meaningful
- Follow mentor feedback and repository guidelines
📄 refer #23 – Important Contributing Guidelines for OpenSource Compass
Follow these steps to set up the project locally and start contributing.
Click the Fork button on GitHub to create a copy under your account.
git clone https://github.com/YOUR-USERNAME/OpenSource-Compass.git
cd OpenSource-CompassOpen index.html directly in your browser or use a local development server.
Make changes → Test → Push → Create Pull Request
✏️ Fix typos and improve writing
🎨 Make it look better and prettier
📝 Add new guides and tutorials
🐛 Find and fix bugs
💡 Share awesome ideas
Step 1: Create a New Branch
git checkout -b feature/your-feature-nameImplement your updates following project guidelines.
Ensure everything works correctly before committing.
git add .
git commit -m "Brief description of your changes"git push origin feature/your-feature-nameStep 6: Create a Pull Request Go to GitHub and click "Create Pull Request". Done! 🚀
✔️ Ask questions - we love helping!
✔️ Read the existing code first
✔️ Make small, focused changes
✔️ Test your work
✔️ Be nice and respectful
❌ Don't make huge changes all at once
❌ Don't ignore feedback from reviewers
❌ Don't add random files
❌ Don't be mean to people
❌ Don't skip testing
Be awesome. Be kind. Be respectful.
We don't accept:
- 😠 Rudeness or bullying
- 👎 Mean comments
- 🚫 Discrimination
- 💬 Hateful language
Everyone is welcome here! 🌈
Join these cool programs and get recognized! 🏆
- SWOC - Social Winter of Code 🎿
- GSSoC - GirlScript Summer Code 👩💻
- GSoC - Google Summer of Code 🚀
- Hacktoberfest - October fest! 🎃
- Getting Started Guide
- Git & GitHub Tutorial
- Programs Hub
- Video Library
- Tips & Tricks
We want to know! Tell us! 📢
- Check if someone already reported it
- Click "New Issue" on GitHub
- Write what happened
- We'll fix it! ✅
- 📝 Add more program guides
- 🎨 Make the design cooler
- 📱 Fix mobile issues
- 🎥 Add video tutorials
- 🌍 Translate to other languages
- ⭐ Share your success story
We're planning:
- 📱 Mobile app
- 👤 User accounts
- 💬 Forums & discussions
- 🏅 Achievement badges
- 🌐 Many languages
- 🤖 AI helper
⭐ Give us a star on GitHub!
🍴 Fork and contribute
💬 Share feedback
📣 Tell your friends
MIT License = You can use, modify, and share freely! 🎉
Big thanks to everyone contributing! You make this awesome! 💖
📧 Open an issue on GitHub
💬 Join our discussions
📚 Check our guides