Skip to content

OpenSource Compass is a beginner-friendly, community-driven platform that guides students and first-time contributors in open source. It offers Git/GitHub basics, contribution best practices, do’s and don’ts, and a hub for programs like SWOC, GSSoC, GSoC, Hacktoberfest, etc

License

Notifications You must be signed in to change notification settings

tanishqasharma29/OpenSource-Compass17

 
 

Repository files navigation

🌍 OpenSource Compass

✨ Lost in open source? We've got your map! 🗺️

OpenSource Compass Banner

Open Source GitHub Issues GitHub License


🚀 What is OpenSource Compass?

Your ultimate guide to jumping into the open source world! No fancy jargon. No confusing steps. Just real answers for beginners who want to start contributing and making an impact.

Think of us as your friend who knows all the shortcuts! 🤝


💡 Our Promise

We believe: Every developer deserves a clear path to contributing.

We deliver: Simple guides, real examples, and friendly community support to get you started.


🎯 What You'll Learn Here

📖 Guides 🎥 Resources 💬 Community
Step-by-step tutorials Video lessons Support & help
Do's and Don'ts Articles & tips Mentorship
Real examples Learning paths Making friends

✨ Amazing Features

🔥 Beginner Friendly Guides - No experience needed!

🚀 Quick Start Instructions - Get going in 5 minutes

🎓 Learn Git & GitHub - From zero to hero

📚 Tons of Resources - Videos, articles, everything

🌟 Program Information - SWOC, GSSoC, GSoC & more

🤝 Community Support - We've got your back!


💻 What We Use

  • HTML5 - Beautiful structure
  • CSS3 - Stunning design
  • JavaScript - Cool features
  • JSON - Smart data handling

📂 How It's Organized

OpenSource-Compass/
├── 📄 index.html (Main page)
├── 📁 guides/ (Learning materials)
├── 📁 programs/ (Open source programs)
├── 📁 resources/ (Videos & articles)
├── 🎨 css/ (Beautiful styling)
├── ⚙️ js/ (Interactive features)
└── 📊 data/ (Program info)

🎬 Getting Started (Super Easy!)

1️⃣ Fork the Repo

Click "Fork" on GitHub. Done! ✅

2️⃣ Clone It

git clone https://github.com/YOUR-USERNAME/OpenSource-Compass.git
cd OpenSource-Compass

3️⃣ Open & Play

Double-click index.html or use a server. That's it! 🎉

4️⃣ Time to Contribute

Make changes → Test → Push → Create Pull Request ✨


🤝 How to Help (We Need You!)

💪 Ways to Contribute

✏️ Fix typos and improve writing

🎨 Make it look better and prettier

📝 Add new guides and tutorials

🐛 Find and fix bugs

💡 Share awesome ideas


📋 How to Send Your Changes

Step 1: Create your own branch

git checkout -b feature/amazing-idea

Step 2: Make your magic! ✨

Step 3: Test everything in your browser

Step 4: Save your work

git add .
git commit -m "Add something awesome"

Step 5: Push to GitHub

git push origin feature/amazing-idea

Step 6: Create a Pull Request Go to GitHub and click "Create Pull Request". Done! 🚀


✅ Do These Things

✔️ Ask questions - we love helping!

✔️ Read the existing code first

✔️ Make small, focused changes

✔️ Test your work

✔️ Be nice and respectful


❌ Don't Do These Things

❌ 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


💝 Code of Conduct

Be awesome. Be kind. Be respectful.

We don't accept:

  • 😠 Rudeness or bullying
  • 👎 Mean comments
  • 🚫 Discrimination
  • 💬 Hateful language

Everyone is welcome here! 🌈


🌟 Open Source Programs

Join these cool programs and get recognized! 🏆

  • SWOC - Student Winter of Code 🎿
  • GSSoC - GirlScript Summer Code 👩‍💻
  • GSoC - Google Summer of Code 🚀
  • Hacktoberfest - October fest! 🎃

📚 Learn More

Right Here:

  • Getting Started Guide
  • Git & GitHub Tutorial
  • Programs Hub
  • Video Library
  • Tips & Tricks

Out There:


🐛 Found a Bug?

We want to know! Tell us! 📢

  1. Check if someone already reported it
  2. Click "New Issue" on GitHub
  3. Write what happened
  4. We'll fix it! ✅

🎁 Cool Ideas to Contribute

  • 📝 Add more program guides
  • 🎨 Make the design cooler
  • 📱 Fix mobile issues
  • 🎥 Add video tutorials
  • 🌍 Translate to other languages
  • ⭐ Share your success story

🚀 What's Coming Next?

We're planning:

  • 📱 Mobile app
  • 👤 User accounts
  • 💬 Forums & discussions
  • 🏅 Achievement badges
  • 🌐 Many languages
  • 🤖 AI helper

👥 Join Us!

Love what we do?

⭐ Give us a star on GitHub!

🍴 Fork and contribute

💬 Share feedback

📣 Tell your friends


📜 License

MIT License = You can use, modify, and share freely! 🎉


🙏 Special Thanks

Big thanks to everyone contributing! You make this awesome! 💖


❓ Need Help?

📧 Open an issue on GitHub

💬 Join our discussions

📚 Check our guides


🚀 Quick Links

Repository | Issues | Pull Requests


❤️ Made with Love for the Open Source Community

Let's make open source awesome for everyone!

⭐ Please star if this helps you! ⭐

About

OpenSource Compass is a beginner-friendly, community-driven platform that guides students and first-time contributors in open source. It offers Git/GitHub basics, contribution best practices, do’s and don’ts, and a hub for programs like SWOC, GSSoC, GSoC, Hacktoberfest, etc

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • HTML 59.4%
  • CSS 20.7%
  • JavaScript 19.9%