RoadmapsProjects
Sign in./start

Learn

RoadmapsProjects

Contribute

DiscoverIssues

Account

Sign in./start-building

Become an Open Source Builder. Learn. Build. Contribute.

Learn

RoadmapsProjectsStart Building

Contribute

DiscoverIssues

Account

Sign inDashboardSettings

Legal

PrivacyTerms

© 2026 Pull // all rights reserved

PrivacyTerms

lesson // bitcoin

Contribution Rubric

Shared bar for a meaningful first open-source contribution on Pull — scope, quality, and maintainer-ready communication.

intermediate3 days

Public lesson — sign in to track progress on this roadmap.

./sign-in

On this page

Learning objectives

  • Score a contribution attempt against an explicit meaningful-PR rubric
  • Separate docs/tests/good-first issues from drive-by noise
  • Write maintainer-ready issue comments and PR descriptions

study // plan

Lessons are primers. Depth comes from required reading, interactive labs, reflection, and a hands-on check with evidence — the BOSS study pattern.

Research on Bitcoin Search

Required reading

  • docsBitcoin Core CONTRIBUTING
  • articleConventional comments

Reflection prompts

  1. Which rubric rows would your last (or planned) PR fail today, and how will you fix them before asking for review?
  2. What evidence would convince a maintainer this change is safe to land?
  3. How will you respond to a NACK or request for deeper tests without derailing?

Lab // Rubric self-score

Pick a real issue on a Bitcoin or Lightning repo. Write a one-page plan and self-score it 0–2 on each rubric row below before coding.

evidence required

  • ·Issue URL and your approach doc
  • ·Rubric score table (0–2 per row) with notes
  • ·Draft first issue comment or PR body

A meaningful PR is not measured by lines changed. It is measured by clarity, testability, and respect for maintainer time — the same bar Btrust/Chaincode-style BOSS programs expect.

Rubric (score each 0–2)

Row012
Problem fitVague / wrong repoPlausible issueConfirmed with maintainers or clear GOOD FIRST ISSUE + skill match
ScopeKitchen-sinkSlightly wideMinimal diff that solves one stated problem
CorrectnessUntested claimManual check onlyAutomated test, scripted repro, or documented verification steps
CommunicationDrive-by dumpBasic descriptionContext, motivation, alternatives, and how to review
CitizenshipIgnores guideSkims CONTRIBUTINGFollows CONTRIBUTING, style, CI, and review norms

Ship bar: total ≥ 8/10 before you request maintainer review.

Evidence pack for Pull review

When you submit contribution progress on Pull, include:

  1. Issue / PR URLs
  2. Rubric self-score
  3. What you tested (commands, CI link, or Polar/regtest notes)
  4. Open questions for reviewers

Anti-patterns

  • Drive-by refactors unrelated to the issue
  • “LGTM” reviews with no reading
  • Demanding merge timelines
  • Mainnet experiments as proof

Docs and tests count

Documentation, vectors, and test coverage are first-class contributions — often better first PRs than consensus code.

further reading

  • articleBitcoin Optech: Contribution culture

progress // sign in

Reading is public. Sign in to mark lessons complete, sync across devices, and unlock your roadmap.

./sign-in-to-track
prevCode Review PracticenextMaintainer Collaboration

On this page

Press Shift + ? for keyboard shortcuts.

Press R to research on Bitcoin Search.