# Documentation office hours - March 20, 2025

**URL:** <https://community.jenkins.io/t/documentation-office-hours-march-20-2025/28595>\
**Category:** Community\
**Tags:** meeting, sig-docs\
**Created:** [March 20, 2025, 7:35pm UTC](https://community.jenkins.io/t/documentation-office-hours-march-20-2025/28595 "2025-03-20T19:35:41Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![kmartens27](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/kmartens27/32/1645_2.png) [@kmartens27](https://community.jenkins.io/u/kmartens27)\
**Post date:** [March 20, 2025, 7:35pm UTC](https://community.jenkins.io/t/documentation-office-hours-march-20-2025/28595/1 "2025-03-20T19:35:41Z")

</div>

[![](https://europe1.discourse-cdn.com/flex013/uploads/jenkins/original/2X/5/5895880d6d579894bc62c4a10f72e47eba40dbf3.jpeg "2025 03 20 Docs Office Hours") ](https://www.youtube.com/watch?v=yeST2WOrE_U)

Agenda

## 2025-03-20

Attendees:

- Kevin Martens
- Bruno Verachten
- Birajit
- Meg McRoberts
- Patrik Mane
- Mark Waite

Agenda

- Contributor spotlight
  - Next spotlight, featuring Yaroslav Afenkin, will be published by the end of this week or beginning of next week.
    - Will also be performing additional interviews over the coming weeks for further 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
    - Mark uses Docker CE (Docker Desktop for Ubuntu 22.04 - make run)
    - Kris uses a macOS with Docker (make run)
      - Kevin also using this setup and seems to work
      - Others have shared that they have run things successfully

    - Meg is seeing many complaints about file permissions

  - Meg opened [an issue to track it](https://github.com/jenkins-infra/jenkins.io/issues/7844) (record what others need to do)
    - Docker minimum version is much older than the version she has
    - Kevin added links to various docker installation instructions (Docker engine & docker desktop)

  - Potentially work with Mark on initial setup/run

- Documentation fixes implemented
  - Disable search indexing of the [docs.jenkins.io](http://docs.jenkins.io) prototype site
    - Oleg Nenashev detected that [docs.jenkins.io](http://docs.jenkins.io) is appearing in Google search results
      - Searched for “Jenkins documentation officer” and outdated page on [docs.jenkins.io](http://docs.jenkins.io) was returned as 2nd link

    - Kris opened a pull request to add the needed robots.txt file at [chore: add robots.txt file to versioned docs site to prevent indexing by krisstern · Pull Request #249 · jenkins-infra/docs.jenkins.io · GitHub](https://github.com/jenkins-infra/docs.jenkins.io/pull/249) and [chore: disallow robots from antora site via playbook config by krisstern · Pull Request #250 · jenkins-infra/docs.jenkins.io · GitHub](https://github.com/jenkins-infra/docs.jenkins.io/pull/250)
      - Appears to have resolved the issue

- [2025 Jenkins Community awards](https://www.jenkins.io/blog/2025/03/18/jenkins-contributor-awards-2025-nomination-is-open/)
  - 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

- [Design Library 3](https://www.jenkins.io/blog/2025/01/10/design-library/)
  - Released in January
  - Updated UX SIG docs to include this/link to blog post

- Google Summer of Code - Kris Stern
  - [Blog announcing Jenkins in GSoC 2025](https://www.jenkins.io/blog/2025/03/05/Jenkins-in-Google-Summer-of-Code-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)
    - Lots of interest in projects, recordings will be available
      - [Recording for Mar 5, 2025](https://youtu.be/d2wuC1Ij_vs) available
      - [Recording for March 6, 2025 available](https://youtu.be/n7tkFLVgs10)

- [Chinese documentation site](https://www.jenkins.io/zh/) and [Chinese localization plugin](https://plugins.jenkins.io/localization-zh-cn/)
  - Planned to retire it, but there are 58,000 installations of the [Chinese localization plugin](https://plugins.jenkins.io/localization-zh-cn/)
  - 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 will create a new issue to initiate adding native Chinese (both traditional and simplified) localization to Jenkins core natively
    - [https://issues.jenkins.io/browse/JENKINS-75364](https://issues.jenkins.io/browse/JENKINS-75364)

  - 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
  - [2.492.3 changelog & upgrade guide for review](https://github.com/jenkins-infra/jenkins.io/pull/7992), scheduled for Apr 2, 2025
    - RC available today

  - [2025-03-05 Security Advisory published](https://www.jenkins.io/security/advisory/2025-03-05/)
    - Jenkins Core

  - [2025-03-19 Security Advisory published](https://www.jenkins.io/security/advisory/2025-03-19/)
    - Only plugins

- Jenkins Contributor Summit
  - Very successful, lots of work in the breakout groups and discussions overall
  - Blog post recap to come from Mark Waite

- Recent work
  - Thanks to [Jim](https://github.com/jimklimov) for additional [updates to the Jenkins on Kubernetes docs](https://github.com/jenkins-infra/jenkins.io/pull/7963)
  - Thanks to [Kris](https://github.com/krisstern) for the [updates](https://github.com/jenkins-infra/jenkins.io/pull/7968)/[adjustments](https://github.com/jenkins-infra/jenkins.io/pull/7967) for the [Thank you feature](https://github.com/jenkins-infra/jenkins.io/pull/7966)
  - Thanks to [Raviraj](https://github.com/Lonwwolf14) for updating the [Apache reverse proxy docs with Unix Domain Socket info](https://github.com/jenkins-infra/jenkins.io/pull/7970)
  - Thanks to [Clinton](https://github.com/clintonsteiner) & [Pratik](https://github.com/PratikMane0112) for their work on the merchandise page to [remove broken shops](https://github.com/jenkins-infra/jenkins.io/pull/7960) and [update with additional links](https://github.com/jenkins-infra/jenkins.io/pull/7962) respectively
  - Thanks to [Colleen](https://github.com/cabarbato) for creating the [Leeroy Jenkins logo](https://github.com/jenkins-infra/jenkins.io/pull/7985)

- 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 sure about second collaboration yet, still time for them to make decisions

- 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.