Documentation office hours - May 01, 2025

Community
,
1

2025-05-01

Attendees:

  • Kevin Martens
  • Birajit Saikia
  • Meg McRoberts
  • Mark Waite

Agenda

  • Contributor spotlight
    • Latest spotlight, featuring Sacha Labourey, published
      • Ilan Rabinovitch for May spotlight
      • Meg McRoberts shared her response for a future spotlight
      • Spotlights to be published once per month
  • Documentation fixes implemented
    • Added Java 21 upgrade instructions as they were absent
    • Updated all installation guides (as needed) for Java 21
    • Updated Jenkinsfile runner tutorial for Java 21
    • Updated Docker tutorial partial for Java 21
    • Only remaining mentions of Java 17 are historical (blog posts, older changelogs, etc)
    • Compiling all areas changed for Java 21 for eventual update to Java 25
  • 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
    • 3 Categories:
      • Most Valuable Contributor
      • Most Valuable Advocate
      • Security MVP
    • Voting started on April 22 and will close on June 5
    • Winners will be announced at cdCon 2025 (June 23 - 25 2025)
    • Last year’s winners are not eligible for the same award this year
      • 2024 Security MVP cannot win 2025 Security MVP again, but could win Most Valuable Contributor
  • Redesigning Jenkins by Jan Faracik
    • Part 1 of indepth look into the process/work that UX SIG and others have been doing and continues to do
    • Explains the challenges of updating Jenkins due to legacy technologies & the expansive nature of the project
    • Part 2 to come
  • Upcoming blog post for latest Pipeline Graph View/revamped Pipeline visualization
  • Google Summer of Code 2025 - Kris Stern
    • Proposal rankings completed and submitted
    • More than a total of 200 submissions this year
    • 160+ valid proposals submitted and being reviewed
    • Planning to have 5 projects ideas to be selected by Jenkins mentoring team this year, with final number of projects to go ahead to be determined by Google
    • Confirmed contributors will be announced on May 8th UTC by Google
  • 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
    • 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
  • LTS and Weekly releases
  • Recent work
  • 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.
  • Google Season of Docs program is closed - Mark Waite
    • Announced in a Google Group
      • The 84 Google Season of Docs case studies (and the final project reports from the 2019-2020 seasons) will continue to be accessible on the program website. Additional materials, including a documentation maturity audit tool and guidance for working with technical writers, are available in the Open Docs Repo on GitHub.
        We’re also excited to release two new resources based on analysis of the Google Season of Docs case studies: a set of new documentation project archetypes to help open source maintainers identify and scope typical projects and (coming soon) a guide to running documentation projects for open source maintainers. More information will be announced via the Google Open Source Blog.
    • Six years of Google Season of Docs - Jenkins participated in one year of Season of Docs (Kubernetes docs)
    • Kevin to review pages for any mentions of this and make sure they are described accurately.