ConsenSys documentation guide
Welcome to the ConsenSys documentation guide. This guide contains information about contributing to ConsenSys developer documentation sites and creating new documentation sites.
Overview
Each ConsenSys developer product has a documentation site, maintained by the ConsenSys developer documentation team and/or a product team. The docs use a docs-as-code approach and are mostly open source, empowering developers and community members to contribute to the docs alongside the docs team.
This guide aims to help writers, developers, product managers, and community members contribute to the existing doc sites and create new doc sites.
This guide assumes familiarity with Git, GitHub, and Markdown.
Most of the doc sites are built using the Docusaurus static site generator and hosted on Vercel.
List of documentation sites
The following table shows the full list of developer documentation sites supported by ConsenSys.
Doc site | GitHub repository | Site platform | Hosting platform | Description |
---|---|---|---|---|
Teku | consensys/doc.teku | Docusaurus | Vercel | Maintained by the docs team. |
Hyperledger Besu | hyperledger/besu-docs | Docusaurus | GitHub Pages | Maintained by the docs team. This is a Hyperledger project and has its own Besu docs contribution guidelines. |
Web3Signer | consensys/web3signer | Docusaurus | Vercel | Maintained by the docs team. |
MetaMask | metamask/metamask-docs | Docusaurus | GitHub Pages | Maintained by the docs team. This project has additional MetaMask docs contribution guidelines. |
Infura | infura/docs (private) | Docusaurus | Vercel | Maintained by the docs team. |
Truffle | trufflesuite/trufflesuite.com | MkDocs | GitHub Pages | Maintained by the Truffle team. |
Linea | consensys/doc.zk-evm | Docusaurus | Vercel | Maintained by the Linea team. |
ConsenSys NFT | consensys/doc.consensys-nft (private) | Docusaurus | Vercel | Maintained by the ConsenSys NFT team. |
MetaMask Fiat On-Ramp | consensys/doc.metamask-onramp (private) | Docusaurus | Vercel | Maintained by the MetaMask Fiat On-Ramp team. |
GoQuorum | consensys/doc.goquorum | Docusaurus | Vercel | Maintained by the docs team. |
Orchestrate | consensys/doc.orchestrate (private) | Docusaurus | Vercel | Maintained by the docs team. |
Tessera | consensys/doc.tessera | Docusaurus | Vercel | Maintained by the docs team. |
EthSigner | consensys/doc.ethsigner | Docusaurus | Vercel | Maintained by the docs team. |
gnark | consensys/doc.gnark | Docusaurus | Vercel | Maintained by the docs team. |
Documentation guide (this site) | consensys/docs-template | Docusaurus | Vercel | Maintained by the docs team. |