Documentation office hours - April 03, 2025

Community
,
1

Agenda

2025-04-03

Attendees:

  • Kevin Martens
  • Birajit Saikia
  • Meg McRoberts
  • Patrik Mane
  • Mark Waite
  • 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 open now until Apr 14, 2025
    • 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 - Kris Stern
    • Review of draft proposals currently under way
    • GSoC contributor application closes on April 8th, 2025
      • Currently more than 50 proposals submitted for proper review/ranking
    • Blog announcing Jenkins in GSoC 2025
    • New project ideas
      • Chatbot plugin inside Jenkins to answer user question
        • Mostly Jenkins resources/where to find, not necessarily how to do things in Jenkins
      • Improving Tekton Client Plugin for Jenkins
      • Kris plans to interview candidates to mentored projects
    • New potential mentors
      • V. Sreenivas
      • Vibhav Bobade
    • Completing versioned docs site/alternative build tools
      • Mentors would be Kris Stern and Kevin Martens (and maybe also Bruno)
        • Lots of activity in GSoC gitter channel, multiple people interested
        • Potentially starting from scratch for the Gatsby part only vs working from what was done in ‘23, but definitely reusing the Antora part from the 2023 project
          • May be more consistent to start over but further discussions will be had
    • Stories site retooling/rebuild/modernize (to some degree)
      • May want to standardize how the stories site is (compared to spotlight)
        • Multiple people interested in this as well
    • Project overview meetings held (March 5 & 6)
  • 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
    • 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 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.