chore: update sidebar to include 'global-communities' and remove 'career-development-communities'; delete outdated documentation files

Author: ghanem-mhd

docs/career-development-communities.md

@@ -1,7 +1,3 @@
----
-sidebar_position: 4
----
-
 # CI/CD
 
 You’ve merged your pull request, tests are green, and everything looks good locally. Time to relax and move on? Not quite. In modern development, merging code is just the start. Your changes now enter the CI/CD pipeline—a set of automated steps that move code from your machine to production. Teams expect more than clean code; they expect you to understand and take ownership of the full lifecycle. CI/CD isn’t just jargon—it’s the core engine of DevOps, enabling fast, reliable delivery through automation and best practices.

docs/ci-cd.md

@@ -1,7 +1,3 @@
----
-sidebar_position: 2
----
-
 # Git
 
 You've written some great code and saved the file. Maybe you even zipped the project folder and named it project-final-v2-really-final.zip as a backup. Your work is safe and you're ready to share it with the team, right? Not quite. That old habit of manually managing versions is a recipe for confusion and lost work in any professional team.

docs/git.md

@@ -0,0 +1,84 @@
+# Global Communities
+
+Building a successful tech career is not just about your technical skills—it's about connecting with the right communities that can guide you, support you, and open doors to opportunities you might never find on your own. By joining global tech communities, you gain access to resources that can help you grow professionally, find international opportunities, and connect with others who share similar experiences and ambitions.
+
+## Why it matters
+
+The tech industry moves fast, and staying connected with the right communities can make a big difference in your career growth. These communities offer more than just networking—they help with mentorship, job opportunities, interview preparation, and insights into what companies are really looking for.
+
+Here's why joining global tech communities helps your career:
+
+- **Access to opportunities**: Many jobs are shared in communities before they appear on job websites.
+- **Real-world advice**: Get honest feedback from people who work at the companies you want to join.
+- **Interview preparation**: Practice with others and learn from their experiences.
+- **Career guidance**: Connect with professionals who can guide your career decisions.
+- **Industry knowledge**: Stay updated on trends, technologies, and what skills companies need.
+
+## Career programs that help you grow
+
+### [Imagine Foundation](https://www.joinimagine.com/)
+
+Imagine Foundation helps software engineers, data scientists, and product managers find tech jobs in Europe and other countries. What makes Imagine special is their personal approach—they don't just give generic advice, but work with you individually to improve your chances of success.
+
+**What they offer:**
+
+- **360° feedback**: A detailed 15-page report showing your strengths and areas where you need to improve.
+- **Personal career coaching**: One-on-one sessions with volunteer coaches who understand European hiring.
+- **CV and LinkedIn help**: Professional feedback to make your profile better.
+- **Job recommendations**: Direct connections to their 200+ partner companies.
+- **Interview coaching**: Preparation for technical and behavioral interviews.
+
+**Two programs available:**
+
+- **Job Booster (Free)**: Digital training, feedback, and coaching to get you started.
+- **Fellowship (Pay when you get hired)**: Complete support until you land a job, including unlimited coaching and direct company connections.
+
+Imagine has helped over 700 developers from around the world, including many from the Middle East, successfully get jobs at European tech companies.
+
+### [Manara](https://manara.tech/)
+
+Manara focuses on helping software engineers and data scientists across MENA (Middle East and North Africa) learn AI and Cloud computing skills while connecting them to global job opportunities. All their programs are completely free.
+
+**What they offer:**
+
+- **AI and Cloud training**: Courses taught by Silicon Valley experts and AWS-certified teachers.
+- **Community support**: Study groups, mentorship, and peer learning.
+- **Interview practice**: AI-powered interview prep and expert-led sessions.
+- **Career assessment**: Professional review of your skills and resume.
+- **Job placement support**: Connections to global companies looking for MENA talent.
+
+**Popular learning paths:**
+
+- AWS AI Practitioner.
+- AWS Intro to Cloud Computing.
+- AI Fundamentals (coming soon).
+
+Manara has trained over 150,000 learners across MENA and helped many get positions at companies like Amazon, Google, Meta, and Microsoft.
+
+## Reddit Career Communities
+
+Reddit has some of the most active and helpful career discussion communities for developers. These communities are where people share real experiences, ask for advice, and support each other through career challenges.
+
+**[r/cscareerquestions](https://reddit.com/r/cscareerquestions)** The largest career community for computer science professionals with over 900,000 members. This is where you'll find:
+
+- Salary discussions and company reviews.
+- Interview experiences and preparation tips.
+- Career advice from junior to senior levels.
+- Resume reviews and feedback.
+- Industry trends and job market insights.
+
+**[r/cscareerquestionsEU](https://reddit.com/r/cscareerquestionsEU)** Specifically focused on tech careers in Europe, this community is particularly valuable if you're interested in European opportunities. You'll find:
+
+- European job market insights.
+- Visa and relocation advice.
+- Company-specific information for European tech firms.
+- Salary information for European markets.
+- Cultural tips for working in different European countries.
+
+**How to use these communities effectively:**
+
+- **Read the rules**: Each subreddit has specific rules for posting.
+- **Search first**: Your question might already be answered in previous posts.
+- **Be specific**: Generic questions get generic answers.
+- **Give context**: Share your background, location, and specific situation.
+- **Help others**: Answer questions in areas where you have experience.

docs/global-communities.md

@@ -1,5 +1,73 @@
----
-sidebar_position: 5
----
-
 # Mentorship
+
+You have worked hard on tutorials, built your own projects, and maybe even got your first job as a developer. But sometimes you face problems that are very hard to solve by yourself. Maybe you are confused about how to make big decisions in your code, how to grow in your career, or what to learn next. Having someone with more experience to guide you can really help. In today's fast-changing tech world, having a mentor is not just useful—it can be the difference between growing as a developer or feeling stuck and alone.
+
+## Why it matters
+
+Growing as a software developer is not just about writing more code or learning new tools. It's about learning how to think like an experienced developer, making good decisions when things get difficult, and building the skills that really matter when you work with a team.
+
+Here's why having a mentor helps you grow faster:
+
+- **Learn from someone else's experience**: A mentor has already made mistakes and learned from situations you haven't seen yet. They can help you avoid common problems and see opportunities you might miss.
+- **Get a learning plan made for you**: Instead of following random tutorials, a mentor can look at your specific situation and guide you toward the skills that will help your career the most.
+- **Understand how things really work**: Mentors help you understand the gap between what you learn alone and how things actually work in real jobs. They help you understand not just "what" to do but "why" you should do it.
+- **Learn about career growth**: Technical skills are important, but they're not everything. A mentor can help you understand how teams work, how to communicate better, and how to find opportunities to grow.
+- **Build confidence**: Having someone believe in you and give you honest feedback helps you take on challenges you might otherwise avoid.
+
+Simply put, mentorship gives you years of experience in focused advice that fits your specific needs.
+
+## Where to find mentors
+
+While there are many global platforms that connect developers with mentors worldwide, the Syrian tech community has built something special—dedicated initiatives created by Syrian developers who understand our unique challenges and opportunities. These platforms don't just offer mentorship; they provide a bridge between Syrian talent and the global tech ecosystem. What makes these initiatives unique is that they're built by Syrian developers who have navigated the same challenges you're facing, and they're completely free to use.
+
+### [Mentory](https://mentory-sy.net/)
+
+Created by Syrian developers to connect Syrian developers with experienced mentors around the world. The platform offers different types of mentorship including technical guidance, career advice, academic support, and startup mentoring. With over 169 expert mentors from 27 countries, you can find someone who understands both your technical needs and cultural context. The mentors are Syrian professionals working at major tech companies globally, bringing real-world experience from international markets while understanding the Syrian context.
+
+### [ProHelpify (P8Y)](https://prohelpify.com/en)
+
+Another Syrian-led initiative that offers free consultation sessions with software experts. Their mentors work at companies like Meta, Tradinos, and other major tech organizations, providing insights into both local and international opportunities. The platform covers everything from interview preparation to career planning, with a focus on helping Syrian developers transition into global tech roles.
+
+## How to be a good mentee
+
+Getting the most from mentorship is not just about finding someone to help you—it's about being someone who is worth helping. Good mentees make the relationship valuable for both people and get the most growth for themselves.
+
+### Come Ready and Focused
+
+Show respect for your mentor's time by making every conversation useful and productive. This means doing your homework before each conversation and coming with specific questions or problems.
+
+- **Ask specific questions**: Instead of "What should I learn next?", ask "I'm working on a React project and having trouble with state management. Can you help me understand when to use Context vs Redux?"
+- **Share your work**: Bring code examples, project demos, or specific problems you're facing. Real examples lead to better advice.
+- **Set clear goals**: Work with your mentor to decide what you want to achieve in the next few months. This could be learning a technology, getting better at code reviews, or preparing for a senior developer role.
+
+### Be Consistent and Reliable
+
+Building a strong mentorship relationship needs consistency and follow-through. Treat your mentorship commitments as seriously as you would any work commitment.
+
+- **Keep your commitments**: If you schedule regular check-ins, show up prepared and on time
+- **Do what your mentor suggests**: Actually try the suggestions your mentor gives you, and tell them how it went
+- **Communicate early**: If you can't make a meeting or need to change the schedule, tell them in advance
+
+### Listen Well and Ask Follow-Up Questions
+
+Mentorship conversations are most valuable when you really engage with the advice you get. Don't just collect advice—understand the thinking behind it.
+
+- **Ask "why" questions**: Understanding the reasons behind recommendations helps you use similar thinking in new situations.
+- **Ask for clarification**: If something isn't clear, ask for examples or different explanations.
+- **Take notes**: Write down key insights and action items so you can look back at them later.
+
+### Share Your Progress and Problems
+
+Keep your mentor informed about your development, including both successes and struggles. This helps them give you better guidance and adjust their approach as needed.
+
+- **Share your wins**: Tell them about accomplishments that came from their guidance
+- **Be honest about difficulties**: If you're struggling with something they recommended, explain what's not working
+- **Ask for changes**: If your goals or situation changes, work with your mentor to adjust your learning path
+
+### Give Back When You Can
+
+Mentorship doesn't have to be a one-way relationship. Look for ways to provide value back to your mentor and the broader community.
+
+- **Share useful resources**: If you find articles, tools, or opportunities that might interest your mentor, share them.
+- **Offer your skills**: You might be able to help with a project, give feedback on something they're working on, or share insights from your unique perspective.
+- **Help others**: As you grow, look for opportunities to help other developers who are earlier in their journey.

docs/mentorship.md

@@ -1,7 +1,3 @@
----
-sidebar_position: 4
----
-
 # Observability
 
 In modern software development, you don’t just build an application and hope it runs smoothly. You need to understand its internal state and behavior from the outside, across the entire stack—from a user's tap on a mobile screen to the deepest database query. This is observability. It’s not just about watching for errors (that’s monitoring); it’s about being able to ask questions about your system to understand why things are happening, especially in complex, distributed environments.

docs/observability.md

@@ -1,2 +1,108 @@
+# Open Source
 
-# Open Source
+Contributing to open source is one of the best ways to grow as a developer, build your reputation, and connect with developers around the world. Open source gives you a way to show your skills to international employers and build professional relationships across borders.
+
+## Why it matters
+
+Open source contributions are more than just free work—they are investments in your professional development and career growth. Today, employers care more about practical experience than just certificates. Your open source contributions work like a public portfolio of your skills, work habits, and ability to work with others.
+
+Here's why open source contributions help your career grow faster:
+
+- **Public portfolio**: Your contributions are visible to anyone, anywhere in the world, showing proof of your skills and consistency.
+- **Real-world experience**: Working on production code used by thousands of people teaches you things tutorials never will.
+- **Code review and feedback**: Experienced maintainers will review your code, giving you valuable feedback that helps you improve.
+- **Professional networking**: You'll work with developers from around the world, building relationships that can lead to job opportunities.
+- **Learn from big projects**: You'll see how large, complex projects are built and learn best practices from experienced teams.
+
+## How to get started
+
+### Start Small and Be Consistent
+
+The biggest mistake new contributors make is trying to work on major features right away. Successful open source contributors start with small, easy contributions and build their reputation over time. Some great ways to get started include:
+
+- Fixing typos in README files or documentation
+- Improving code comments or adding missing documentation
+- Reporting bugs you find while using the project
+- Suggesting improvements to user guides or examples
+
+### Choose Projects Wisely
+
+Not all open source projects are good for beginners. Look for projects that welcome new contributors and have clear contribution guidelines.
+
+**Look for these signs of a welcoming project:**
+
+- Clear README with setup instructions
+- Contribution guidelines (usually in a CONTRIBUTING.md file)
+- Issues labeled "good first issue" or "beginner-friendly"
+- Active maintainers who respond to issues and pull requests
+- Code of conduct that promotes respectful collaboration
+
+**Start with tools and libraries you already use:**
+
+The best place to start is with tools and libraries you already use in your work or personal projects. You understand the problems they solve and can spot areas for improvement.
+
+- If you use React, contribute to React-related projects
+- If you work with Node.js, find Node.js libraries that need help
+- If you're learning a new framework, contribute to its ecosystem
+
+**Use GitHub's discovery features:**
+
+GitHub provides several ways to find projects that need help:
+
+- **GitHub Explore**: Visit github.com/explore to see trending projects, filter by language and topics you're interested in
+- **Good First Issues**: Search for "good first issue" labels across GitHub using GitHub's search filters
+- **Up For Grabs**: Visit up-for-grabs.net for a curated list of beginner-friendly projects organized by programming language
+
+**Consider Syrian and Arabic projects:**
+
+Look for projects created by Syrian developers or Arabic-speaking communities for easier communication, local context understanding, and stronger networking within the Syrian tech community.
+
+### Follow Project Standards
+
+Every project has its own way of doing things. Successful contributors learn and follow these standards rather than using their own preferences.
+
+**Before making your first contribution:**
+
+- Read the project's README completely
+- Review existing pull requests to understand the style and process
+- Check if there are coding standards or style guides
+- Look at recent commits to understand the project's direction
+
+**When submitting contributions:**
+
+- Follow the project's commit message format
+- Write clear, descriptive pull request descriptions
+- Include tests if the project requires them
+- Be responsive to feedback and requests for changes
+
+### Build Good Relationships
+
+Open source is about community, not just code. Building relationships with maintainers and other contributors is just as important as the technical contributions.
+
+**Engage respectfully, professionally, and communicate clearly:**
+
+- Be patient when waiting for reviews—maintainers are often volunteers.
+- Ask questions when you don't understand something.
+- Offer help to other contributors when you can.
+- Participate in project discussions and decisions.
+- Write clear, simple issues and pull request descriptions.
+- Be specific about problems and proposed solutions.
+
+## Resources
+
+### English Resources
+
+- **[🎥 How to Contribute to Open Source Projects – A Beginner's Guide](https://www.freecodecamp.org/news/how-to-contribute-to-open-source-projects-beginner-guide/)**
+- **[📚 GitHub's Guide to Open Source](https://opensource.guide/)**
+- **[🎥 Open Source Explained](https://youtu.be/PVD1LNDxOnc)**
+- **[📚 First Timers Only](https://www.firsttimersonly.com/)**
+- **[🔗 Good First Issues](https://goodfirstissues.com/)**
+- **[🔗 Up For Grabs](https://up-for-grabs.net/)**
+- **[📚 How to Write the Perfect Pull Request](https://github.blog/2015-01-21-how-to-write-the-perfect-pull-request/)**
+
+### Arabic Resources
+
+- **[🎥 مقدمة في Open Source والمساهمة في المشاريع المفتوحة](https://youtu.be/3HqN-YS8eso)**
+- **[🎥 كيف تساهم في المشاريع مفتوحة المصدر؟](https://youtu.be/GNKPKhme8eM)**
+- **[🎥 أهمية المشاريع مفتوحة المصدر للمطورين](https://youtu.be/YL-f8WSw7I8)**
+- **[📚 دليل المطور العربي للمساهمة في المشاريع مفتوحة المصدر](https://blog.itwadi.com/posts/open-source-contribution-guide/)**

docs/open-source.md

@@ -1,7 +1,3 @@
----
-sidebar_position: 3
----
-
 # Testing
 
 You’ve implemented the feature and tested it manually. Now you’re ready to move on to the next task—right? Not quite. The old idea of a developer writing code and tossing it over to QA is outdated. In today’s agile environments, you're expected to be the first and most important line of defense for code quality. It’s no longer enough for your code to "just work on your machine." To grow as a developer, you need to treat testing as a core part of your workflow—not an afterthought. Here’s what modern teams typically expect from you when it comes to testing.

docs/testing.md

@@ -1,7 +1,3 @@
----
-sidebar_position: 1
----
-
 # Web
 
 ## Why it matters