# Documentation Office Hours - Sep 1, 2023

**URL:** <https://community.jenkins.io/t/documentation-office-hours-sep-1-2023/9332>\
**Category:** Community\
**Tags:** meeting, sig-docs\
**Created:** [September 1, 2023, 4:05am UTC](https://community.jenkins.io/t/documentation-office-hours-sep-1-2023/9332 "2023-09-01T04:05:57Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![MarkEWaite](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/markewaite/32/20_2.png) [@MarkEWaite](https://community.jenkins.io/u/MarkEWaite)\
**Post date:** [September 1, 2023, 4:05am UTC](https://community.jenkins.io/t/documentation-office-hours-sep-1-2023/9332/1 "2023-09-01T04:05:57Z")

</div>

2023-09-01T03:00:00Z

[![](https://europe1.discourse-cdn.com/flex013/uploads/jenkins/original/2X/b/bd11c65d77cbce40a87601b7bad34c0867ed2386.jpeg "2023 09 01 Docs Office Hours") ](https://www.youtube.com/watch?v=Iux9Deb0L9U)

## 2023-09-01 (Asia)

Attendees

- Mark Waite
- Kris Stern
- Ashutosh Saxena

Agenda

- Blog posts
  - See the latest entries
    - [RISC-V](https://www.jenkins.io/blog/2023/08/30/a-glimpse-of-the-future/) from Bruno
    - [Docker compose summaries](https://www.jenkins.io/blog/2023/08/24/gsoc-docker-based-quickstart/) from Ashutosh
    - [GitLab plugin modernization](https://www.jenkins.io/blog/2023/08/24/gitlab-plugin-modernization-report/) from Harsh

- Google Summer of Code
  - Docker compose for easier and safer tutorials
    - Successfully completed!
    - 4 or 5 tutorials now execute with a single command
    - Remaining work
      - Create a docker container repository in jenkins-infra
      - Create a docker folder on Dockerhub
      - Create jobs to maintain those containers
        - Already maintenance configured, not yet running on [ci.jenkis.io](http://ci.jenkis.io)

  - Versioned documentation for [Jenkins.io](http://Jenkins.io) - Vandit Singh
    - Very near a working Antora site with versioned documentation
    - The Gatsby integration still needs some work
    - Abandoned the strapi backend idea for blog post review
    - Will simplify the process by using GitHub to review blog posts
    - Next steps
      - Focus on fixing Antora site links (most fixed, need another pass)
      - No automation to repair the links, will need to read the log files for links
        - Needs more study of the output and how it works

      - Some hope for later automation
      - Need to check the links interactively

    - Project may be able to complete all the planned milestones
      - Blog is easier now that we’re not using the strapi backend, stay with GitHub

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

    - Project has completed successfully
    - Harsh has agreed to continue as a plugin maintainer (that is first time a contributor became a maintainer)

  - Plugin health score
    - Discussions on Gitter related to an issue
      - Score calculation is flawed in some way

    - Adrien was working on code improvements that may help Jagruti’s work (if Mark remembers correctly)
    - Possible future action is on GitHub in an issue by Alex Brandes
      - One more probe that can be implemented

    - Jagruti mentioned on the third party repo probe again
      - There was an issue with how to detect the third party repositories

    - Need to check project documentation, may need additional documentation
      - Consider it for Hacktoberfest

- How to describe the process of choosing a plugin bill of materials version
  - No progress since last week
  - 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)
  - Discussion, next steps, etc.
  - More work needed, pictures to help explain
  - Mark show his picture (draft form)

- Adding existing requirements/support policy documentation to System Administration section (new chapter/sections)
  - Diagnosing Kevin’s prototype - debug session

- DevOps World Tour - Mark owes a blog post
  - Business benefits of contributing to open source - New York, Chicago, and Santa Clara - Mark Waite
  - Singapore - Olivier Lamy
  - London - Tim Jacomb