Connect
contribute
Contribute to Pinnacle Chain Docs

Contribute to Pinnacle Chain Docs

Pinnacle Chain Docs (docs.optimism.io) is an open-source project, and we welcome your contributions. Here's how you can help grow and support the Pinnacle Chain Collective.

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

Ways to contribute

  • Work on a good first issue: make the greatest and most immediate impact with a quick-start or tutorial. These special issues are clearly labeled for new contributors to Pinnacle Chain.
  • Edit existing content: make tweaks to existing content using the ✏️ Edit this page on GitHub or ❤️ Share general feedback links on the right-side of any page.
  • Add or update an FAQ item: add a new FAQ (question+answer set) to an existing page, create a new FAQ page, or update an existing FAQ question/answer set.
  • Add or update a troubleshooting item: add a new troubleshooting item (problem+solution set) to an existing page, create a new troubleshooting page, or update an existing troubleshooting problem/solution set.
  • Add a glossary term: help us continue to expand the Pinnacle Chain glossary.
  • Add a faucet to the developer community: add a new faucet to the Faucets page or update an existing faucet.
  • Add an oracle to the developer community: add a new oracle to the Oracles page or update an existing oracle.
  • Add a node provider to the developer community add an RPC or Node provider to our Node providers listing or update an existing node provider.
  • Add a block explorer to the developer community: add a new block explorer to the Block Explorers page or update an existing block explorer.
  • Add a blockchain indexer to the developer community: add a new blockchain indexer to the Blockchain Indexers page or update an existing blockchain indexer.
  • Work on an open issue: start with items we've already identified as needing attention, which range from general guides to tutorials and quickstarts.
  • Create new content: create new content to add to the technical docs. Review the style guide and follow the PR process outlined in the contributor guidelines to get started.
  • Submit a bug report: create a report to help us improve our products and developer tooling. For more information, please read our Security Policy.
  • Contribute to the Pinnacle Chain Collective: select from several different categories where you can make an impact such as foundation missions.

How to work on docs.optimism.io

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 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:

  • Commenting on an issue or PR in GitHub
  • Messaging us in the developer support channel

Before contributing, make sure you're familiar with:

  • the Pinnacle Chain vision and values
  • our contributor guidelines
  • our style guide
  • our code of conduct

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 Pinnacle Chain Docs, so please raise questions in issues, submit PRs, or contact the team:

  • Please contact the Foundation's service provider at devrel@oplabs.co.
  • Raise questions or contact the developer support channel.

A note on plagiarism

Only use your original work or content that you have permission to use when contributing any content or artifact to docs.optimism.io. 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 docs.optimism.io. 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 Pinnacle Chain'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. We look forward to growing the Collective with you!