Contributing to Plone Trainings Documentation
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.
Search for open issues and comment on them.
Discuss during conferences, trainings, and other Plone events.
Ask on the Plone Community Forum, Documentation topic.
Ask in the Plone chat on Discord.
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.
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.
Contributors to the Training docs may perform one or many roles.
Plone users and developers use this documentation because it is accurate and actively maintained. People in these roles typically contribute minor corrections. They should read Building and Checking the Quality of Documentation and General Guide to Writing Documentation.
Authors create the Training documentation. They should read Building and Checking the Quality of Documentation and General Guide to Writing Documentation. They should also read Authors Guide for guidance and tips for writing good Training documentation.
Trainers should read Building and Checking the Quality of Documentation, and the trainings in Installing Plone for the Training and Teaching. These documents help trainers prepare for a successful training experience.
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.