Documentation office hours - May 29, 2025

Community
,
1

2025-05-29

Attendees:

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

Agenda

  • Contributor spotlight
  • Documentation fixes implemented
  • 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)
  • Revamped Pipeline Visualization by Jan Faracik
    • Highlights and reviews the updates to Pipeline Graph View
    • Examples of it in Jenkins
  • 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 - Kris Stern
    • 5 projects selected - congratulations and looking forward to the program!
      • Includes retooling of 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 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
      • 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.
    • 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
    • Looking to restock the good first issues
    • A number of work in progress pages
      • Kris to create issue for this
  • LTS and Weekly releases
  • Recent work
  • Google Season of Docs program is closed - Mark Waite
    • Announced in a Google Group
    • Six years of Google Season of Docs - Jenkins participated in one year of Season of Docs (Kubernetes docs)
    • Kevin updated the pages mentioning GSoD to indicate its conclusion.
      • One more page 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
      • 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.
1 Like