Documentation office hours - June 12, 2025

Community
,
1

2025-06-12

Attendees:

  • Kevin Martens
  • Birajit Saikia
  • Bruno Verachten
  • Kris Stern
  • Meg McRoberts

Agenda

  • Contributor spotlight
    • Latest spotlight, featuring Ilan Rabinovitch/SCaLE, published
      • Meg McRoberts to be featured in next spotlight
      • Melissa from JFrog has been sent questionnaire
      • Lance Albertson from OSUOSL as potential spotlight
  • Java 25 documentation
    • 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
    • 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)
  • Android and Jenkins: What is the limit? (Part 2)
    • Thanks to Bruno Verachten for writing this up
    • Second part to the original Android & Jenkins blog post
    • Reviews running Jenkins on an Android device (including adding agents and building a project from GitHub)
  • Google Summer of Code 2025
  • Chinese documentation site and Chinese localization plugin
    • Planned to retire it, but there are 58,000 installations of the Chinese localization plugin
    • 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
      • 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
      • Will need to have a meeting with Mark Waite to discuss details later when Mark will be free
      • Planning to happen in parallel to the GSoC 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.
      • May not use the exact same tooling as the docs.jenkins.io site, but will follow as much as possible what can be done. Propose to use Docusaurus – https://docusaurus.io/ for the revamped Chinese site.
    • 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
  • LTS and Weekly releases
    • Next LTS 2.504.3, scheduled for June 25, 2025
      • backporting ticket
        • One jetty/winstone update (2 dependencies) to backport
        • Need to create entries stating no notable changes
    • 2.513 changelog - Jun 3, 2025
    • 2.514 changelog - Jun 10, 2025
    • Mark Waite has started discussion in developer mailing list around next LTS baseline selection (suggesting 2.514) so that it captures all recent changes, such as redesigned header
  • Recent work
  • Google Season of Docs program is closed - Mark Waite
  • 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 (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
      • 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.
      • Kevin has created a couple redirects, but has found that if there are multiple URLs that contain the same string, it may confuse the redirect behavior
  • Potentially removing Java 11 upgrade instructions
  • 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.