Contribute to Metal L2 Docs
Metal L2 Docs(docs.metall2.com) is a fork of the Optimism docs, an open-source project. We welcome your contributions. Here's how you can help grow and support Metal L2. Please visit the Optimism docs (opens in a new tab) to contribute to Optimism.
Ways to contribute
- Work on a good first issue (opens in a new tab): make the greatest and most immediate impact with a quick-start or tutorial. These special issues are clearly labeled for new contributors to Metal L2.
- 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 (opens in a new tab): 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 a glossary term (opens in a new tab): help us continue to expand the Metal L2 glossary.
- Add a faucet to the developer community (opens in a new tab): add a new faucet to the Faucets page (opens in a new tab) or update an existing faucet.
- Add an oracle to the developer community (opens in a new tab): add a new oracle to the Oracles page (opens in a new tab) or update an existing oracle.
- Add a node provider to the developer community (opens in a new tab) add an RPC or Node provider to our Node providers listing (opens in a new tab) or update an existing node provider.
- Add a block explorer to the developer community (opens in a new tab): add a new block explorer to the Block Explorers page (opens in a new tab) or update an existing block explorer.
- Add a blockchain indexer to the developer community (opens in a new tab): add a new blockchain indexer to the Blockchain Indexers page (opens in a new tab) or update an existing blockchain indexer.
- Work on an open issue (opens in a new tab): start with items we've already identified as needing attention, which range from general guides to tutorials and quickstarts.
- Create new content (opens in a new tab): create new content to add to the technical docs. Review the style guide and follow the PR process outlined in the contributor guidelines (opens in a new tab) to get started.
- Submit a bug report (opens in a new tab): create a report to help us improve our products and developer tooling. For more information, please read our Security Policy.
How to work on Metal L2 Docs
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:
- Commenting on an issue or PR in GitHub (opens in a new tab)
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 Metal L2 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 docs.metall2.com. 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.metall2.com. Any pull requests deemed as plagiarism will get rejected.