Contributing to Plone Trainings Documentation

This document describes how to contribute to the Plone Trainings Documentation.

Contributions to the Plone Trainings documentation are welcome.

Granting permission to publish

Before you contribute, you must give permission to publish your contribution according to the license we use. You may give that permission in two ways.

  • Sign the Plone Contributor Agreement. This method also covers contributions to Plone code. It is a one-time only process.

  • In every pull request or commit message, include the following statement.

    I, [full name], agree to have this contribution published under Creative Commons 4.0 International License (CC BY 4.0), with attribution to the Plone Foundation.

The Plone Trainings Documentation is licensed under the Creative Commons Attribution 4.0 International License (CC BY 4.0). A copy of the license is included in the root of this repository.

Managing contributions on GitHub

Contributions are managed through the Training repository on GitHub.

First discuss whether you should perform any work. Any method below is acceptable, but are listed in order of most likely to get a response.

As a convenience, at the top right of every page, there is a GitHub navigation menu. Tap, click, or hover over the GitHub Octocat icon for options.

GitHub navigation menu

You can use this menu to quickly navigate to the source repository, open an issue, or suggest an edit to the current document. Of course, you can use whichever tools you like.

Next edit files, commit your changes, push them to the remote repository, and submit a pull request to resolve the issue.

Members who subscribe to the repository will receive a notification and review your request.

Contributor Roles

Contributors to the Training docs may perform one or many roles.

Documentation quality requirements

We use GitHub Actions with every pull request to enforce Training documentation quality. We recommend that you build the documentation locally to catch errors and warnings early on. See Building and Checking the Quality of Documentation for instructions for how to set up and build the documentation and to run quality checks.

Code of Conduct

The Plone Foundation has published a Code of Conduct. All contributors to the Plone Trainings Documentation follow the Code of Conduct.