Skip to content

CONTRIBUTING.md

Latest commit

 

History

History
104 lines (71 loc) · 4.28 KB

CONTRIBUTING.md

File metadata and controls

104 lines (71 loc) · 4.28 KB
Raw

Contributing to Code Orange Dev School

Your path from curious Bitcoiner to Bitcoin open-source contributor.

Quick Start

  1. Join our Discord: https://discord.gg/PrHct9eY6Z — introduce yourself in #introductions
  2. Pick your starting point based on where you are (see below)
  3. Show up — we run bi-weekly sessions at Bitcoin House Bali and remote cohorts on Discord

Where to Start

"I'm new to Bitcoin"

→ Join the Reading Club (The Bitcoin Standard, Mastering Bitcoin) → Attend a Sovereign Bitcoiner workshop (nodes, self-custody, multisig) → No technical background needed

"I understand Bitcoin but haven't coded on it"

→ Join the Bitcoin Dojo (7 weeks, Chaincode BOSS Challenge) → Or join rawBit (10 weeks, elliptic curves to Taproot) → You'll write your first Bitcoin scripts and understand the protocol

"I can code and want to contribute to Bitcoin"

→ Join Decoding Bitcoin (8 weeks, transaction deep dive) → Or jump into the Privacy Track (24 sessions, chain analysis through CoinSwap) → You'll submit your first PR to a real Bitcoin project

"I'm already contributing and want funding"

→ Apply for a Developer Fellowship ($500/mo, 6 months) → Pick a project, get a mentor, ship code: fellowship@codeorange.dev → Details: https://github.com/code-orange-dev/fellowships

"I want to teach Bitcoin in my community"

→ Apply for an Educator Fellowship ($250/mo, 6 months) → Run cohorts and workshops in your city using our CC0 curriculum → Details: https://github.com/code-orange-dev/fellowships

Contributing to Our Repos

All our curriculum is CC0-licensed. You can use, adapt, and improve it.

How to contribute

  1. Fork the repo you want to improve
  2. Make your changes (fix typos, improve exercises, add examples, translate)
  3. Submit a PR with a clear description of what you changed and why
  4. We'll review within a week

What we're looking for

  • Typo fixes and clarifications — always welcome
  • New exercises — especially hands-on coding exercises with real Bitcoin tools
  • Translations — Bahasa Indonesia, Thai, Vietnamese, Korean, Portuguese
  • Improved examples — real-world scenarios, better explanations
  • New workshop materials — slides, handouts, facilitator guides

Repos open for contribution

Repo What It Is Good For
curriculum All cohort syllabi Adding exercises, translations, improvements
workshops Workshop slide decks and materials New topics, translations, facilitator notes
PR-tracking-dashboard Monthly PR tracking Updating your own contributions

Your First Bitcoin Open-Source PR

Not sure where to start contributing to Bitcoin itself? Here are beginner-friendly projects our community contributes to:

Project Language Good First Issues
rust-bitcoin Rust Documentation, tests, small fixes
BDK Rust Wallet tooling, tests
Floresta Rust Light client node, good first issues labeled
BlueWallet React Native Translations, UI improvements
BTCPay Server C# Merchant payments, documentation
peer-observer Rust P2P network monitoring

Pro tip: Start by reading the project's CONTRIBUTING.md, then look for issues labeled good first issue or help wanted. Our Discord has a #contribution-help channel where you can ask questions.

Code of Conduct

We're here to learn and build. Be respectful, be helpful, be patient with newcomers. We don't tolerate harassment, discrimination, or toxicity. If someone needs help, help them.

Questions?

Code Orange Dev School | codeorange.dev