Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.

The pages in this section contain information about contributing to the Besu technical documentation. The Besu docs are built using Docusaurus and hosted on GitHub Pages.

If you have any questions about Besu or its documentation, ask on  Discord.

Documentation system overview

At the root of the Besu documentation repository (besu-docs), the docs directory contains all the site documentation, which is generated into a static HTML website using MkDocs and the Material for MkDocs theme.

The documentation is automatically updated using webhooks linking GitHub to the ReadTheDocs site when you merge a pull request in the main branch of the Besu documentation repository.

titleImportant note about Github token renewal

The webhook triggers the Read The Docs build.

This build uses a Github PAT for the hyperledger-bot as environment variable (MKDOCS_GITHUB_USER and MKDOCS_GITHUB_TOKEN) to install MKDocs Material insider theme with Python pip.

The PAT for hyperledger-bot has to be renewed every 90 days by asking 

The PAT probably has to be renewed if RTD build fails with the following error in the builds:

fatal: Authentication failed for ''

The system also detects tags in the GitHub repository and makes the latest stable release and previous versions available.

Required accounts

If you want to contribute to the documentation, you need a Linux Foundation account.

If you want to raise a documentation issue, you need an Atlassian accountthe besu channel on Hyperledger Discord.

Table of contents

Children Display