千亿体育网址

 

Documentation

Overview

This special interest group improves Jenkins use and adoption through documentation. The SIG encourages, creates, and reviews documentation contributions and improves documentation with contributors and external communities.

(Back to List of Jenkins Special Interest Groups )

Description

千亿体育网址The SIG offers a venue for all kinds of documentation creation, improvement, and delivery.

千亿体育网址The group focuses on documentation for Jenkins, including:

Documentation SIG may cooperate with other groups. For example, we will be cooperating with the Cloud-Native Jenkins SIG on topics related to Cloud-Native documentation efforts and with the Platform SIG. on platform topics.

Topics

  • Creating new documentation

  • Improving existing documentation

  • 千亿体育网址Reviewing documentation contributions

  • Coordinating documentation initiatives

  • 千亿体育网址Reviewing Jenkins Enhancement Proposals (JEPs) related to documentation

Contributing

See this page千亿体育网址 for information about contributing to Jenkins documentation. It contains links for newcomer and seasoned contributors. If you have any questions or ideas, please feel free to reach out to us using the channels listed on the right panel.

Projects

This sections lists some of the projects being done under umbrella of this SIG. See the for more information about ongoing projects.

Plugin site integration with GitHub

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 (), but there are still many improvement areas: visualizing changelogs, pulling plugin tags and maintainers list from GitHub, etc. This project is tracked in the EPIC.

Useful links:

Plugin documentation on GitHub

Currently the SIG is migrating plugin documentation from http://wiki.dgpzs.com/ 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 .

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:

User Guide Rework

Jenkins user topics are included in the current Jenkins Handbook千亿体育网址. 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:

Administrator Guide

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 EPIC.

Jenkins on Kubernetes

千亿体育网址Jenkins on Kubernetes is a popular theme of Jenkins Meetups and presentations at conferences. The Jenkins on Kubernetes project will describe the concepts, techniques, and choices for Kubernetes users running Jenkins. The project can refer to existing information from:

  • Jenkins online meetups (like )

  • Cloud providers (like , , , and )

  • 千亿体育网址Training labs (like )

  • 千亿体育网址System providers (like and )

  • Infrastructure as a Service providers (like )

  • 千亿体育网址SCM providers (like )

Solution Pages

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 . Additional use cases and user stories are being collected by .

千亿体育网址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 dgpzs.com. This project is tracked in the EPIC.

Documentation Reviews

  • 千亿体育网址Reviewing Jenkins documentation

  • 千亿体育网址Identifying

  • Reviewing Jenkins documentation pull requests

  • Reviewing Jenkins X documentation

  • Plugins site improvements

Google Season of Docs

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

See this page for more info.

Meetings

Documentation office hours are held each Monday at 22:00 UTC. Meetings are conducted and recorded using Zoom and archived to the in the . Participant links are posted in the 10 minutes before the meeting starts.

The Documentation SIG meets on the fourth Friday of each month at 13:00 UTC. See the Jenkins Event Calendar for the schedule. At these meetings we discuss projects, share presentations, and demonstrate new capabilities. Meetings are conducted and recorded using Zoom and archived to the in the . Participant links are posted in the 10 minutes before the meeting starts.

Meeting Agendas

千亿体育网址Meeting agendas and meeting notes for the SIG are posted in . Anyone is welcome to add a topic for an upcoming meeting by suggesting a change in the .

(Back to List of Jenkins Special Interest Groups)
必威官网体育 betway体育|千亿体育网址 亚洲城ca88官网 188体育官网 hg0088官网 龙虎国际|官网 betway必威官网 betway官网 米乐体育官网 澳门威尼斯官网千亿体育网址