Documentation office hours - February 6, 2025

Community
,
1

2025-02-06T17:00:00Z

2025-02-06

Attendees:

  • Kris Stern
  • Mark Waite
  • Meg McRoberts

Agenda

  • Documentation developer experience - Meg McRoberts
    • Initial documentation development setup was not working
      • Can’t build based on the instructions
      • Mark uses Docker CE (Docker Desktop for Ubuntu 22.04 - make run)
      • Kris uses a macOS with Docker (make run)
      • Meg is seeing many complaints about file permissions
    • Meg opened an issue to track it (record what others need to do)
      • Docker minimum version is much older than the version she has
  • Documentation fixes needed
    • Docs Office Hours are incorrectly described (once every two weeks, twice every week)
  • Google Summer of Code - Kris Stern
    • New project ideas
      • Chatbot plugin inside Jenkins to answer user question
      • Content Security Policy implementation as a GSoC project idea
        • Mark is skeptical of this one, needs more discussion
        • Candidate strength is the biggest concern
      • Kris plans to interview candidates to mentored projects
    • New potential mentor
      • V. Sreenivas
  • Chinese documentation site and Chinese localization plugin
    • Planned to retire it, but there are 58000 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 could draft a project idea to maintain the Simplified Chinese (mainland China)
    • Are the Jenkins users already English speakers and don’t need Chinese localization?
  • LTS releases
    • LTS 2.492.1 released on February 5 2025
    • 2.492.2 release lead is Kris Stern
  • Jenkins Contributor Summit - 31 Jan 2025 in Brussels, Belgium
  • Alpha Omega documentation project idea - improving open source security for Jenkins users - Mark Waite
    • Further discussions at Jenkins Contributor Summit - 31 Jan 2025
  • 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