Documentation

Google Season of Docs brings together open source communities and technical writers for the benefit of both. The program raises awareness of open source, of documentation, and of technical writing.

See our Google Season of Docs status page for documentation project ideas, contact information, and more.

Jenkins Plugin Site currently uses Jenkins update center and Jenkins Wiki as a main source of information to be displayed on the website. We have recently added support of plugin documentation from GitHub (announcement), but there are still many improvement areas: visualizing changelogs, pulling plugin tags and maintainers list from GitHub, etc. This project is tracked in the WEBSITE-637 EPIC.

Useful links:

Currently the SIG is migrating plugin documentation from https://wiki.jenkins.io/ to GitHub. Documentation in the plugin GitHub repository provides a good user experience for Jenkins users seeking documentation. At the same time, plugin maintainers now can follow the documentation-as-code approach and make documentation changes a part of the pull requests. It also gives an opportunity to review the documentation changes and to add documentation contributor recognition, especially if the story is combined with changelog automation.

We have more than 300 plugins which already use GitHub as a documentation source, but there are still hundreds of plugins to migrate. We invite contributors to participate in the project and to help us with migrating the docs. It is also a great opportunity to update and copy-edit the documentation.

Useful links:

Jenkins user topics are included in the current Jenkins Handbook. Feedback requests are frequently received to improve user documentation. Common improvement themes include adding migration of the documentation from Wiki, pipeline examples with each of the pipeline steps, additional tutorials for new users, better search and navigation.

Links:

Jenkins administration topics are included in the current Jenkins Handbook. Navigation can be improved for administrators by separating the administration topics into a separate volume. This project will create a separate Jenkins Administrator Guide with content specific for administrators. This project is tracked in the WEBSITE-738 EPIC.

Jenkins solution pages highlight specific use cases for Jenkins users. Those solutions include SCM provider solutions (GitHub, Bitbucket), programming language solutions (Python, Ruby, C/C++, Java, and PHP), and execution environment solutions (Pipeline, Docker, Embedded, and Android). An excellent opening page has been provided by Zbynek Konecny. Additional use cases and user stories are being collected by Alyssa Tong.

The appearance and navigation of those solution pages needs improvement. The existing pages should be revisited and improved so that users of specific solutions can find what they need on jenkins.io. This project is tracked in the WEBSITE-742 EPIC.

Meeting agendas and meeting notes for the SIG are posted in this Google Document. Anyone is welcome to add a topic for an upcoming meeting by suggesting a change in the agenda.