Documentation office hours - April 17, 2025

Community
,
1

2025-04-17

Attendees:

  • Kevin Martens
  • Birajit Saikia
  • Meg McRoberts
  • Patrik Mane
  • Kris Stern

Agenda

  • Contributor spotlight
    • Latest spotlight, featuring Yaroslav Afenkin, published
      • Sacha Labourey & Ilan Rabinovitch interviewed for future spotlights
      • Spotlights to be published once per month
  • Documentation developer experience - Meg McRoberts
    • Initial documentation development setup was not working
      • Can’t build based on the instructions
      • Meg is seeing many complaints about file permissions
      • Has gotten better since installing Docker
    • Meg opened an issue to track it (record what others need to do)
    • Potentially work with Mark or Kevin on initial setup/run
  • Documentation fixes implemented
  • 2025 Jenkins Community awards
    • 3 Categories:
      • Most Valuable Contributor
      • Most Valuable Advocate
      • Security MVP
    • Nomination period closed earlier this week
    • Voting will start on April 22 and 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
  • Google Summer of Code 2025 - Kris Stern
    • Proposal rankings under way
    • More than a total of 200 submissions this year
    • 160+ valid proposals submitted and being reviewed
    • Planning to have about 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
    • Deadline for org to submit rankings by April 29th UTC
    • 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 documentation project 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.
  • Java 25 documentation
1 Like