This is the repository for all project documentation under the PaperMC umbrella. At this point, only the main Paper Server project is documented here.
This repository publishes to PaperMC's documentation site, currently hosted here; on RTD.
The published public documentation for the currently supported PaperMC implementation lives on the master branch.
PaperMC has a small team of active developers that focus most of their time on the main server implementation (Paper) itself. In order to keep this documents up-to-date and in good quality, we rely on your contributions. In a perfect world we'd have an individual or team dedicated to documentation, but we currently do not.
We appreciate any and all contributions we receive and hope that if you see something that needs changing, you'll help us out. Thanks.
You can set up an environment, so you can instantly see the changes that make to the docs.
- Install Python 3
- Install the needed sphinx packages
After installing Python 3 (as well as python-pip), run the following command to install the sphinx packages:
$ pip install --user -r requirements.txt
You may need to add the user binary directory to $PATH
To build the source into a proper HTML site, run the following command on Linux/macOS/WSL
$ make html
To build the source on Windows without WSL, open CMD and execute the make.bat script:
make.bat html
To automatically rebuild the HTML files as you edit the .rst source files, execute the following command:
$ make auto
Open your browser and connect to the address provided by the command. When you make a change to the documentation, the docs should refresh in the browser (possibly after a few seconds).
If you need anything else not covered above, you can contact us directly via IRC or Discord
- PaperMC on Discord (Invite Link)
- #Paper on EsperNet (Webchat)
This project is based on the awesome work done by the SpongePowered team and all those who helped them with their SpongeDocs platform. Therefore, it is only appropriate we thank them for all their hard work that allowed us to build our own based on the structures they created for their own platform.