The Raspberry Pi Documentation website is built from Asciidoc source using a Jekyll and Python toolchain. The website is automatically deployed to the raspberrypi.org site — pushed to production — using GitHub Actions when a push to the master branch occurs.
Full instructions for building and running the documentation website locally can be found in the top-level README.md file.
In order to contribute new or updated documentation, you must first create a GitHub account and fork the original repository to your own account. You can make changes, save them in your repository, then make a pull request against this repository. The pull request will appear in the repository where it can be assessed by the maintainers, copy edited, and if appropriate, merged with the official repository.
NOTE: Unless you are opening a pull request which will only make small corrections, for instance to correct a typo, you are more likely to get traction for your changes if you open an issue first to discuss the proposed changes.
We welcome contributions from the community, ranging from correcting small typos all the way through to adding entire new sections to the documentation. However going forward we're going to be fairly targetted about what sort of content we add to the documentation. We are looking to keep the repository, and the documentation, focussed on Raspberry Pi-specific things, rather than having generic Linux or computing content.
NOTE: We are willing to consider toolchain-related contributions, but changes to the toolchain may have knock-on effects in other places so it is possible that apparently benign pull requests that make toolchain changes could be refused for fairly opaque reasons.
In general we will not accept content that is specific to an individual third-party service or product. We will also not embed, or add links, to YouTube videos showing tutorials on how to configure your Raspberry Pi.
The documentation is under a Creative Commons Attribution-Sharealike (CC BY-SA 4.0) license. By contributing content to this repository you are agreeing to place your contributions under this license.