JedianeOS — A Sudanese-born open source community. We empower, connect, and amplify Sudanese tech talent through collaborative open source projects, training, and community-led impact.

• Mission: Equip Sudanese technologists with the skills, tools, and networks needed to build open source projects that solve real-world challenges in Sudan and beyond.
• Vision: A thriving, self-sustaining hub of Sudanese open source projects — led by contributors from local communities and connected with global collaborators.
• Approach: Hybrid model — Network + Incorporated Association — so we can scale community-driven work while maintaining the structure needed to receive funds, partnerships, and legal protections.

• Jediane Website & Platform — public site, community dashboard, events & project listings. (jediane-website)
• Governance & Policies — transparent charter, roadmap, election rules, Code of Conduct. (jediane-governance)
• Open-source projects — community projects (education, civic tech, dev tooling, localization) curated and incubated by the community. (see projects/ folder and repo list)

1. Why JedianeOS?
2. How to get involved
3. Quickstart for contributors
4. Core projects & repos
5. Roadmap (phases)
6. Governance & interim setup
7. Values & Code of Conduct
8. Sponsor / Partner / Donate
9. Maintainers & contacts

Sudan has abundant technical talent, but practical infrastructure, mentorship networks, and visible pathways into meaningful open source contribution are still growing. JedianeOS focuses on:

• Real experience — projects that are useful, visible, and resumable.
• Skill transfer — regular workshops, mentorship, and community code reviews.
• Local impact — projects solving infrastructure, civic, education, and healthcare problems relevant to Sudanese communities.
• Open collaboration — clear contribution paths and governance so contributions matter and are recognized.

Whether you’re a student, hobbyist, professional, or an expert, there’s a place for you.

• Discover: Browse repos → pick a project labeled good first issue or help wanted.
• Join: Jump into our Discord (see docs/COMMUNICATION.md) or open an issue to say “I want to help”.
• Contribute: Fork → branch → PR. We provide templates and a CI pipeline to help you.
• Mentor & Lead: Join working groups, propose projects, or become a project maintainer.

We keep tasks small and onboarding-friendly. Look for tags: good first issue, beginner-friendly, docs-request.

# Clone the monorepo (recommended)
git clone https://github.com/JedianeOS/jediane-website.git
cd jediane-website

# Copy env example
cp .env.example .env

# If using Docker:
docker-compose up --build

# Or follow /frontend/README.md and /backend/README.md for stack-specific dev

Branching & PRs

• Branch: feature/<short-description> or fix/<short-description>
• PR base: main
• Include related issue number and a short description of testing steps

Checklist

• Run the repo linters and tests
• Add or update docs
• Respect CODE_OF_CONDUCT.md and CONTRIBUTING.md

• jediane-website — frontend + backend monorepo (recommended starter repo)
• jediane-governance — Governance, policies, implementation roadmap, election rules
• jediane-projects/* — incubated project repos (data tools, civic apps, education tooling)
• jediane-docs — community manuals, workshop materials, training curriculum

(This list grows as projects are proposed and incubated — check the org repos page for the latest.)

We commit to:

• Collaboration & empathy
• Openness & transparency
• Quality & inclusivity
• Practical impact & responsible innovation

All contributors must follow our Code of Conduct. Violations are handled transparently by the governance committee. See CODE_OF_CONDUCT.md in each repo.

Contributing to open source comes in many shapes and sizes. Skills, interests, availability, and project needs all matter — and everyone is welcome to contribute in any field. Below are common (and some often-overlooked) ways contributors help JedianeOS succeed, with short descriptions so you can find the best fit for you.

• Code Contributions Implement features, fix bugs, add integrations, or refactor code. Includes writing backend APIs, frontend UI, libraries, and services.

• Documentation Write or improve README files, getting-started guides, API docs, tutorials, runbooks, and design docs. Great for beginners and high impact.

• Testing & Quality Assurance Add unit, integration, and end-to-end tests; run manual QA; design test plans; and help keep releases stable.

• Bug Reporting & Issue Triage Reproduce bugs, file clear reports, prioritize issues, add reproduction steps, and tag/route tasks for maintainers.

• Code Review Review PRs for correctness, style, test coverage, and security; offer constructive feedback and help maintain code quality.

• Design & UI/UX Create wireframes, mockups, accessibility audits, and pixel-perfect UI; design user journeys and interaction patterns.

• Community Management Moderate chat, welcome newcomers, organize events, manage forums, and keep community channels healthy and inclusive.

• Project Management Plan roadmaps, manage backlogs, coordinate releases, run sprint planning, and ensure projects meet milestones.

• Localization & Translation Translate UI strings, docs, and tutorials; help make projects accessible to Arabic and other language communities.

• Security Contributions Audit code, triage security reports, run vulnerability scans, and help define secure defaults and response plans.

• Financial & Infrastructure Support Sponsor hosting, fund event costs, provide cloud credits, manage treasury, or handle bookkeeping and grant admin.

• Creating & Maintaining Projects Propose new projects, create starter templates, and take projects through incubation to stable maintenance.

• Mentorship & Teaching Run workshops, code reviews, pair programming, and onboarding sessions to accelerate contributor learning.

• Advocacy & Outreach Promote the community, recruit volunteers, organize meetups and partnerships (local universities, NGOs, companies).

• Legal, Policy & Compliance Help draft contributor agreements, privacy policies, licensing choices, and advise on regulatory issues.

• DevOps / SRE / CI-CD Build and maintain CI pipelines, deployment manifests, and monitoring/observability for production services.

• Accessibility & Inclusion Conduct accessibility audits (WCAG), implement improvements, and advise on inclusive UX and onboarding practices.

• Data & Research Collect and analyze metrics, run user research, build dashboards, or provide data science expertise for project impact.

• Content, Media & Marketing Write blog posts, case studies, create video tutorials, and produce materials to showcase contributor work and impact.

• Governance & Policy Work Draft governance docs, run elections, steward committees, and maintain transparency/accountability processes.

• Event Logistics & Volunteer Coordination Organize community days, hackathons, speaker sessions and handle volunteer scheduling and venue arrangements.

• Look for issues labeled good first issue or help wanted.
• Join our community chat and say “hi” in #welcome. Ask for a mentor or pair-up on your first PR.
• Open a short issue describing your skills and availability — project leads will help you find the right task.

• Code: MIT or Apache-2.0 (per-repo choice; Apache for patent grant clarity)
• Docs / Policies: CC BY 4.0 (re-use allowed with attribution)
• Security: See SECURITY.md for responsible disclosure

JedianeOS accepts contributions and sponsorships to sustain workshops, events, and core infra. Transparency is key — financial reports and sponsor agreements are published to jediane-governance/FINANCE.md (summary public; sensitive details redacted as required).

Interested sponsors: email partnerships@jedianeos.org.

1. Say hi: Open an issue or drop a message in #welcome on Discord.
2. Pick a good first issue: Fork the repo, follow CONTRIBUTING.md.
3. Submit PR: Add tests/docs, link the issue, request review — and celebrate your first contribution!

We maintain a rolling mentorship list — volunteers who will review beginner PRs and pair-program when possible.

Contributors are recognized in:

• docs/CONTRIBUTORS.md (public list)
• Project README badges and release notes
• Annual community showcase and spotlight posts

If you’re starting an incubated project under JedianeOS, open a template issue: /repo-template (or contact the Projects Committee). We provide a repo bootstrap template with CI, issue templates, CODE_OF_CONDUCT, and initial label sets.

• Email: fathalrhman@jedianeos.org
• Discord: (see docs/COMMUNICATION.md)
• Twitter / X: @JedianeOS
• LinkedIn: Jediane Open Source Community
• Website: https://jediane.org

JedianeOS is more than code. It’s a pathway for Sudanese talent to learn, contribute, and lead open source efforts that matter locally and globally. If you believe in building skills, sharing knowledge, and shipping software that helps communities — welcome. Let’s build something that lasts.

Ready to begin? → Create an issue, pick a good first issue, or open a PR: https://github.com/JedianeOS/jediane-website