Contribute to Optimism Docs

Contribute to Optimism Docs

Optimism Docs ( is an open-source project, and we welcome your contributions. Here's how you can help grow and support the Optimism Collective.

We recently migrated our technical docs from --> So, if you contributed to either repo in 2023, don't forget to claim your POAP token!

Ways to contribute

How to work on

Whether you're adding to the site, creating content, or working on open issues, you'll 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. Please see the contributor guidelines (opens in a new tab) for more details.

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

Before contributing, make sure you're familiar with:

How decisions about the site are made

Decisions about individual PRs, tutorials, and major docs updates are made by the Developer Relations team. We want to transition to a more community-informed and community-generated approach for the Optimism Docs, so please raise questions in issues, submit PRs, or contact the team:

A note on plagiarism

Only use your original work or content that you have permission to use when contributing any content or artifact to Many projects 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 Any pull requests deemed as plagiarism will get rejected.

Claim your GitPOAP

We use GitPOAPs to recognize our contributors! GitPOAP automatically recognizes your merged contribution and lets you mint a unique contributors POAP directly on their platform.

How to claim

  1. Visit Optimism's GitPOAP page (opens in a new tab).
  2. Connect with your wallet or 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 are able to mint a GitPOAP!

You should only use self-custody wallets to claim POAPs. 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 POAPs.

Still Have Questions?

You can reach us in our developer support forum (opens in a new tab). We look forward to growing the Collective with you!