Contributing to ethereum.org 🦄

Ethereum.org is an open-source run project with 12 000+ contributors that help translate, write, design and maintain the website.

We are a welcoming community that will help you grow and educate in the Ethereum ecosystem while also meaningfully contribute and get relevant practical experience!

Ways to contribute

Translations

• Join the translation program – Help us bring ethereum.org to new languages

Development

• Work on an open issue(opens in a new tab) – Work we've identified that needs doing

Design

• Help design the website Designers of all levels can contribute to improve the website

Content

• Create/edit content – Suggest new pages or make tweaks to what's here already
• Add community resources – Add a helpful article or resource to a relevant page
• Suggest a design resource – Add, update, and delete helpful design resources
• Add a glossary term – Help us continue to expand the Ethereum glossary
• Quizzes – Add, update, and delete quiz question banks for a relevant page

Feature ideas

• Request a feature(opens in a new tab) – Let us know about any ideas you have for a new feature or design

Product listings

• Add an exchange – Add an exchange to our exchange finder
• Add a product – Add a dapp or wallet to a relevant page
• Add developer tools – Add a developer tool to a relevant page
• Add a layer 2 – Add a layer 2 to a relevant page
• Add a staking product or service – Add a project that helps facilitate solo staking, pooled staking, or staking as a service
• Add a wallet – Add a wallet for the find wallets page
• Suggest a project for our DeSci page – Add a project built on Ethereum that contributes to decentralized science

Any questions? 🤔 Join our Discord server(opens in a new tab)

Good first tasks to start contributing

These are few current tasks that you could help us solve and take responsibility for. For most you will need GitHub account as most changes to the website are made through GitHub.

How to work on ethereum.org

If you wish to contribute in the Translation Program, we ask you to create an account on Crowdin(opens in a new tab). For everything else – adding or editing content or visuals to the website, fixing bugs, working on open tasks – you will need a GitHub(opens in a new tab) account.

All updates are made via the GitHub PR process. This means you create a local copy of the website, make your changes and request to merge your changes. If you've never done this before, follow the instructions at the bottom of our GitHub repository(opens in a new tab).

You don't need permission to work on anything, but it's always best to let us know what you're planning to do. You can do this by:

• Commenting on an issue or PR in GitHub(opens in a new tab)
• Messaging on our Discord server(opens in a new tab)

Before contributing, make sure you're familiar with:

• the evolving vision of ethereum.org
• our design principles
• our style guide
• our code of conduct

How decisions about the site are made

Decisions about individual PRs, design evolution and major upgrades are made by a team from across the Ethereum ecosystem. This team includes project managers, developers, designers, marketing and communications, and subject matter experts. Community input informs every decision: so please raise questions in issues, submit PRs, or contact the team:

• website@ethereum.org(opens in a new tab)
• @ethdotorg(opens in a new tab)
• Discord server(opens in a new tab)

A note on plagiarism

Only use your original work or content that you have permission to use when contributing any content or artifact to ethereum.org. Many projects within the Ethereum ecosystem use open-source licensing that allows for the free sharing of information. However, if you cannot find this information, do not attempt to add it to ethereum.org. Any pull requests deemed as plagiarism will get rejected.

New to open-source?

We have low barrier to entry issues on our GitHub repository specifically designed for developers who are new to open-source labelled good first issue(opens in a new tab).

Claim your Onchain Achievement Token (OAT)

If your contribution gets merged into ethereum.org, you will have a chance to claim a special badge on Galxe(opens in a new tab). An Onchain Achievement Token (OAT) is a proof that you helped make the ecosystem a little more awesome.

More on OATs(opens in a new tab)

How to claim

1. Join our Discord server(opens in a new tab).
2. Paste a link to your contribution in the #🥇 | proof-of-contribution channel
3. Wait for a member of our team to send you a link to your OAT.
4. Claim your OAT!

You should only use self-custody wallets to claim OATs. Do not use exchange accounts or other accounts you do not hold the private keys to, as these will not allow you to access and manage your OATs.

Claim your GitPOAP

GitPOAP will also automatically recognize your merged contribution and let you mint a separate unique contributors POAP on their platform itself!

How to claim

1. Visit GitPOAP(opens in a new tab).
2. Connect with your wallet or even with your email through sign in option.
3. Search for your GitHub username, ETH address, ENS names or any GitPOAP to check if you're eligible.
4. If your GitHub account is eligible, then you would be able to mint a GitPOAP!

Contributors

Thanks to our 0 Ethereum community members who have contributed so far!