# Documentation office hours - May 29, 2025

**URL:** <https://community.jenkins.io/t/documentation-office-hours-may-29-2025/32032>\
**Category:** Community\
**Tags:** meeting, sig-docs\
**Created:** [May 29, 2025, 9:41pm UTC](https://community.jenkins.io/t/documentation-office-hours-may-29-2025/32032 "2025-05-29T21:41:55Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![kmartens27](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/kmartens27/32/1645_2.png) [@kmartens27](https://community.jenkins.io/u/kmartens27)\
**Post date:** [May 29, 2025, 9:41pm UTC](https://community.jenkins.io/t/documentation-office-hours-may-29-2025/32032/1 "2025-05-29T21:41:55Z")

</div>

[![](https://europe1.discourse-cdn.com/flex013/uploads/jenkins/original/2X/2/2486cfba06e867efa2e12193cce84ed40a91e09e.jpeg "2025 05 29 Docs Office Hours") ](https://www.youtube.com/watch?v=ds0KDeXGbTc)

## 2025-05-29

Attendees:

- Kevin Martens
- Birajit Saikia
- Bruno Verachten
- Kris Stern
- Mark Waite
- Meg McRoberts
- Rajiv Singh

Agenda

- Contributor spotlight
  - Latest spotlight, [featuring Sacha Labourey](https://contributors.jenkins.io/pages/contributors/sacha-labourey/), published
    - [Ilan Rabinovitch for May spotlight](https://github.com/jenkins-infra/contributor-spotlight/pull/348)
    - Meg McRoberts shared her response for a future spotlight
    - Melissa from JFrog has been sent questionnaire
    - Lance Albertson from OSUOSL as potential spotlight

- Documentation fixes implemented
  - Added [Java 21 upgrade instructions](https://www.jenkins.io/doc/book/platform-information/upgrade-java-to-21/) as they were absent
  - Updated all installation guides (as needed) for Java 21
  - Updated [Jenkinsfile runner tutorial](https://www.jenkins.io/doc/tutorials/using-jenkinsfile-runner-github-action-to-build-jenkins-pipeline/) and Docker tutorial for Java 21
  - Only remaining mentions of Java 17 are historical (blog posts, older changelogs, etc)

- [Java 25 documentation](https://github.com/jenkins-infra/jenkins.io/issues/8002)
  - Thanks to Kris Stern for creating this issue
  - Kevin creating list of areas that will need Java 25 update when it is available
  - Java 21 updates have helped spotlight areas that will need to be updated

- [2025 Jenkins Community awards](https://www.jenkins.io/blog/2025/05/15/jenkins-contributor-awards-cast-your-vote/)
  - Updated blog post and Carousel for voting period
  - 3 Categories:
    - Most Valuable Contributor
    - Most Valuable Advocate
    - Security MVP

  - Voting open (extended) until Jun 16, 2025
  - Winners will be announced at cdCon 2025 (June 23 - 25 2025)

- [Revamped Pipeline Visualization](https://www.jenkins.io/blog/2025/05/02/pipeline-graph-view/) by Jan Faracik
  - Highlights and reviews the updates to Pipeline Graph View
  - Examples of it in Jenkins
    - [Core build with Pipeline Graph View](https://ci.jenkins.io/job/Core/job/jenkins/job/master/lastSuccessfulBuild/)
    - Great replacement for Blue Ocean’s pipeline visualization
    - Link to this in the Blue Ocean status notes/documentation

- [Android and Jenkins: What is the limit? (Part 2)](https://www.jenkins.io/blog/2025/05/22/jenkins-on-android/)
  - Thanks to Bruno Verachten for writing this up
  - Second part to [the original Android & Jenkins blog post](https://www.jenkins.io/blog/2023/03/30/android-and-jenkins/)
  - Reviews running Jenkins on an Android device (including adding agents and building a project from GitHub)

- Google Summer of Code 2025 - Kris Stern
  - [5 projects selected](https://summerofcode.withgoogle.com/programs/2025/organizations/jenkins-wp) - congratulations and looking forward to the program!
    - Includes retooling of [Jenkins.io](http://jenkins.io) (building with Antora & Gatsby)

  - Bonding Period is underway and will conclude early next week
  - Coding Period 1 will commence later next week immediately following the conclusion of the Bonding Period
  - Contributors are making drafts for both the blog posts as well as community engagement emails.
  - Most projects (4 out of 5) has scheduled and conducted a kickoff meeting
  - We are using only Slack channels in the CDF Slack Workspace to communicate for GSoC projects this year

- [Chinese documentation site](https://www.jenkins.io/zh/) and [Chinese localization plugin](https://plugins.jenkins.io/localization-zh-cn/)
  - Planned to retire it, but there are 58,000 installations of the [Chinese localization plugin](https://plugins.jenkins.io/localization-zh-cn/)
  - Runxia Ye and Mark discussed at FOSDEM
    - Check the actual usage of the Chinese with analytics
    - Check the actual usage of Chinese localization

  - Alternative would be to find a funding source to translate latest messages to Chinese
    - Kris has created a new issue to initiate adding native Chinese (both traditional and simplified) localization to Jenkins core natively
      - [https://issues.jenkins.io/browse/JENKINS-75364](https://issues.jenkins.io/browse/JENKINS-75364)
      - Started to work on planning the best way to approach this, will add details to issue over the next few weeks

    - The localization is planned to start sometime Summer 2025

  - Kris recently adopted the Chinese docs site
    - Modernization and updates will happen along with localization efforts starting in summer 2025
    - Planning to happen in parallel to the GSoC [jenkins.io](http://jenkins.io) retooling project, as we will need to match in terms of tech stack for the versioned docs capability, or have some variants of this.

  - Are the Jenkins users already English speakers and don’t need Chinese localization?
  - Potentially include Chinese localization in core and deprecate/disable plugin once it is complete
  - Not enough data to determine one way or another just yet

- Good first issues on [Jenkins.io](http://jenkins.io)
  - Looking to restock the good first issues
  - A number of work in progress pages
    - Kris to create issue for this

- LTS and Weekly releases
  - [2.504.2 Changelog](https://www.jenkins.io/changelog-stable/#v2.504.2) (no notable entries in Upgrade Guide) May 28, 2025
  - [2.511 changelog](https://www.jenkins.io/changelog/#v2.511) - May 20, 2025
  - [2.512 changelog](https://www.jenkins.io/changelog/#v2.512) - May 27, 2025
    - Includes [packaging update from Alex Earl](https://github.com/jenkinsci/packaging/pull/494)

  - [2025-05-14 Security Advisory](https://www.jenkins.io/security/advisory/2025-05-14/)
    - Plugins only

- Recent work
  - Thanks to Jesse Glick for [updating the developer docs](https://github.com/jenkins-infra/jenkins.io/pull/8118) and [adding the `ControllerToAgentCallable`](https://github.com/jenkins-infra/jenkins.io/pull/8117) to the callable-remoting docs.
  - Thanks to [Birajit](https://github.com/biru-codeastromer) for [fixing some important links](https://github.com/jenkins-infra/jenkins.io/pull/8116), [some grammar adjustments](https://github.com/jenkins-infra/jenkins.io/pull/8113), and [additional docs updates](https://github.com/jenkins-infra/jenkins.io/pull/8110). These will all help towards the GSoC project work.

- Google Season of Docs program is closed - Mark Waite
  - Announced in a [Google Group](https://groups.google.com/g/google-summer-of-code-mentors-list/c/t2LIAn1NCEQ/m/sfww4qe-EAAJ)
  - Six years of Google Season of Docs - Jenkins participated in one year of Season of Docs (Kubernetes docs)
  - Kevin updated the [pages mentioning GSoD](https://github.com/jenkins-infra/jenkins.io/pull/8115) to indicate its conclusion.
    - One more [page](https://www.jenkins.io/sigs/docs/gsod/ideas/) that needs an update

- Introducing the header redesign as part of the July LTS
  - Lots of changes to be aware of
  - Benefit from a blog post pointing out the new header
  - What’s new LTS broadcast informing users (.2, .3, next .1)
  - Entries in the upgrade guide reflecting the updated header

- Screenshot updates/review for July LTS
  - New header in July LTS baseline
  - Will Need screenshots where applicable
    - Needs to be determined what will be updated

  - Kevin also working on more specific screenshot guidelines (dimensions, potential tools to use, additional best practices)

- Wiki migration redirect instructions
  - Currently, developer docs instruct users [to create a redirect for the content migrated](https://www.jenkins.io/doc/developer/publishing/wiki-page/#migrating-from-wiki-to-github)
    - No instructions on how to actually create the redirect
    - Kevin partnering with Mark Waite & Damien Duportal on what the process involves and steps needed to create and test
    - Once there are multiple examples, instructions will be updated to include more direct steps/information.
    - Redirects do not account for URL variation so trying to figure out the best way to capture these and redirect as intended.

- Alpha Omega idea - improving open source security for Jenkins users - Mark Waite
  - Further discussions had at Jenkins Contributor Summit - 31 Jan 2025
  - Not expecting any additional projects yet, but Wadeck is working with them periodically
    - Not right now, but maybe later

- Plugin Developer documentation
  - Topic brought by Antoine Neveux at previous office hours
  - Lots of warning signs in the documentation saying “work in progress”
  - How can this be updated/enhanced and provide a more confident experience
  - What would be the best way to address this?
    - Improve a plugin tutorial helps, but does not address the developer documentation directly

- Blue Ocean Deprecation
  - Work to remove Blue Ocean from documentation has begun
  - Tutorials moved towards bottom of page and includes status note
  - Status notes have been updated to indicate alternatives/replacements for pipeline visualization.
