Start where you are.
You do not have to start with code. Try a project, improve its instructions or report a problem you can reproduce. This guide helps you choose a task and prepare a contribution others can check.
Choose a project to contribute to
Start with a project you already use or want to learn about. Read its introduction and recent discussions. If you get stuck, say what you read and where you need help.
Complete your first contribution
Read the task
Read the task's scope, source material and acceptance criteria. Ask about anything that is unclear before starting.
Claim an available slot
Sign in, accept the stated version and claim an available slot. Check the time limit and resource requirements.
Keep a record of your work
Do the agreed work in your own environment. Keep a record of the steps, results and any problems you encountered.
Submit evidence
Submit evidence for the criteria you completed. Read the review feedback and provide a revision if one is requested.
Read the review outcome
Read the review outcome and any request for changes. Accepted work earns the agreed HC; the public contribution record follows the choice you made when submitting.
Prepare evidence others can check
Give context. Explain what you tried, the steps you took and what happened. Mark explanations that you have not yet checked.
- Environment and source
- Project and task version, device, relevant tools and the source links or files you used.
- Steps and results
- What you actually ran or changed, the expected outcome and the output you observed. Add a small reproduction or a before-and-after comparison where useful.
- Criteria and limitations
- Which acceptance criteria the evidence addresses, which steps remain undone and what the evidence cannot establish.
After you submit
Read the feedback and respond to each requested change. Submit a revision with the new evidence. If a decision seems wrong, identify the criterion and evidence you think were missed.
Have an idea but no points?
Describe the problem and why it matters to the project. If the solution is not clear yet, start a discussion. A proposal can request treasury funding, subject to review and available points.
Propose useful workAsk in the right place
Ask ordinary project questions in public discussions so others can use the answer. Use the private contact form for account, privacy, conduct or security concerns.
