# Documentation office hours - September 14 2023

**URL:** <https://community.jenkins.io/t/documentation-office-hours-september-14-2023/9603>\
**Category:** Community\
**Tags:** meeting, sig-docs\
**Created:** [September 14, 2023, 7:37pm UTC](https://community.jenkins.io/t/documentation-office-hours-september-14-2023/9603 "2023-09-14T19:37:43Z")\
**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:** [September 14, 2023, 7:37pm UTC](https://community.jenkins.io/t/documentation-office-hours-september-14-2023/9603/1 "2023-09-14T19:37:43Z")

</div>

[![](https://europe1.discourse-cdn.com/flex013/uploads/jenkins/original/2X/a/afd5b1332cd9d68ed4e49748183dae3bc3ef8941.jpeg "2023 09 14 Docs Office Hours") ](https://www.youtube.com/watch?v=8oQs7QOzgrg)

## 2023-09-14 (EU/US)

Attendees

- Kevin Martens
- [Bruno Verachten](mailto:bverachten@cloudbees.com)

Agenda

- Google Summer of Code
  - Docker compose for easier and safer tutorials - Ashutosh
    - Complete as a project, needs work to deploy and include in the docs
      - Need containers and a repository to host them and jobs to maintain them
      - Need infra team (hope during Hacktoberfest)

  - Versioned documentation for [Jenkins.io](http://Jenkins.io) - Vandit Singh
    - Still developing - see the [demo site](https://vandit1604.github.io/jenkins-ui-project/user-docs/2.2/index.html)
    - Using Gatsby as the front end and GitHub for review
    - Pull requests arriving, blog post layout arrived last week
      - Kris updated the column layout
      - On track to complete in a few weeks

    - Still under development for the final layout
    - Antora site now has fixed most of the broken links and the dropdown menus
      - See the navigation that we did

  - GitLab plugin modernization
    - Interactive testing by Mark Waite has been delayed by work
      - Needs more testing, more comparison of old and new behavior
      - See the test outlines that are in the project meeting notes

  - Plugin health score
    - Two blog posts pull requests from Jagruti - one merged, one pending
      - [Merged pull request](https://github.com/jenkins-infra/jenkins.io/pull/6645) needs changes based on the feedback

    - Progressing towards the end of the project
      - Adrien has returned from holidays

  - Final presentations Sep 14, 2023 - Jenkins Online Meetup
    - Went great! Happy with the results for Jenkins
    - Recording will be available later

- How to describe the process of choosing a plugin bill of materials version
  - No progress since last week
    - None expected for 2-4 weeks due to other priorities

  - Described in [issue 2359](https://github.com/jenkinsci/bom/issues/2359#issuecomment-1672145887)
  - Consider using updatecli to update the version string explicitly in the documentation
  - Consider including static references to older versions in addition to the most recent release
  - Consider adding a blog post that highlights how to do it

- Java 11, Java 17, and Java 21 discussion (see [Google Doc](https://docs.google.com/document/d/1y3RVlniNmz-5Nd3LI-w58LDf760Ai7FqssP4zHuTv8U/edit#heading=h.c8iwpg0yclz) from Mark Waite)
  - Mark has a [timeline diagram](https://docs.google.com/spreadsheets/d/1Gc-0yuYOD5u674qnxbPOWhCU5t9viCJukVj_9b-kwAw/edit?usp=sharing) for discussion with others
  - Discussion, next steps, etc.
  - More work needed, pictures to help explain
  - Mark show his picture (draft form)
  - Going through Tutorials and documentation
    - Works with Java 21

- Adding existing requirements/support policy documentation to System Administration section (new chapter/sections)
  - Pull requests submitted to Kevin’s repo for cleaning up and updating the initial creation
  - Need to update the index page text

- [DevOps World Tour](https://www.devopsworld.com/)
  - Started this week
  - Jenkins “afterhours” session after the conclusion of DevOps World Tour
  - Business benefits of contributing to open source - New York, Chicago, and Santa Clara - Mark Waite
  - Singapore - Olivier Lamy
  - London - Tim Jacomb

- Docs office hours Asia canceled this week since Mark is at DevOps World Tour
- August Newsletter Draft!
  - Shorter, August was a bit slow/quiet for content