Documentation Office Hours - Aug 10, 2023

2023-08-10T16:00:00Z

2023-08-10 (EU/US)

Attendees

  • Mark Waite
  • Kevin Martens

Agenda

  • Jenkins July Newsletter
  • Weekly 2.418 was released this week (August 8 2023)
  • LTS 2.414.1
    • Release - August 23 2023
    • RC released yesterday (August 9 2023)
      • Start the testing
    • Changelog & upgrade guide
      • Upgrade guide still being edited
      • Three regressions tracking - documented but need updates
        • Calendar view - document the issue (no pull request to fix it)
        • Global build stats - pull request to fix it, hope released soon
        • Login theme - document the issue, no fix until 2.414.2
  • Google Summer of Code
    • Versioned documentation for jenkins.io - Vandit Singh
      • Vandit will demo the status at UX SIG Aug 16, 2023
      • Which versions should be in the list of versions?
        • Mark thinks LTS baseline (2.401.1, 2.414.1, …)
        • Meg agrees that LTS baseline is enough (4 times per year)
        • Is there a way that we can cap the number of releases displayed
          • Mark assumed keep all the versions available, but only show a subset in menu
            • Allow “… more”
          • What does Antora do with many versions?
      • Meg asked if there is a way to indicate that a page changed compared to the previous release
    • Docker compose for tutorials - Ashutosh Saxena
      • More to be done, but looking very good
    • GitLab plugin modernization - Harsh Pratap Singh
      • Mark has many things to test
    • Plugin health score - Jagruti Tiwari
      • Moving forward
    • Upcoming dates
      • Midterm evaluations complete and all 4 passed
      • Final evaluation open Aug 28, closes Sep 4
      • Final presentations in mid September
  • Adding existing requirements/support policy documentation to System Administration section (new chapter/sections)
    • Currently, support policy docs are linked in the installation guides and are searchable, but not necessarily in a section in the navigation.
    • Similarly for the Java requirements & Java upgrade docs
    • Support policy could function like “Reverse proxy configurations” with collapsable navigation
    • After installing, it is less likely that users would return to the installation docs
  • Open pull requests of interest
    • Using updatecli for jenkins.io from Bruno Verachten
      • Submits pull request to update tool versions in the documentation
      • Merged and results are now appearing
      • PR-6583 - NodeJS version update from LTS to most recent release (discussion ongoing)
    • Administering Jenkins on Kubernetes from Tanuj Sharma
      • PR-6474 proposes an outline, needs review from those who know Kubernetes
  • Java 11, Java 17, and Java 21 discussion (see Google Doc from Mark Waite)
    • Discussion, next steps, etc.
  • DevOps World Tour web site
    • Sep 13-14 - New York - Mark is speaking
    • Sep 27 - Chicago - Mark is speaking
    • Oct 18-19 - Santa Clara - Mark is speaking
    • Oct 26 - Singapore Olivier Lamy is speaking
    • Nov 29 - London Tim Jacomb is speaking
  • Mark Waite out of office Aug 14, 2023 through Aug 18, 2023
    • Meetings removed from the Jenkins calendar
    • Canceled Asia docs office hours meeting Aug 18, 2023
  • Kevin Martens out of office August 31st 2023
    • Mark will host EU/US docs office hours