Documentation office hours - Feb 2, 2023

MarkEWaite · February 21, 2023, 5:16pm

2023-02-02T17:00:00Z

2023-02-02 (EU/US)

Attendees

Mark Waite
Kevin Martens
Bruno Verachten

Agenda

Action items
- GSoC application blog post from Jean-Marc Messen
Weekly 2.389
- Successful, next week will be 2.390
LTS release 2.375.3
- Changelog & upgrade guide aligned with all backports, merged
- Release will occur on February 8 2023
- Next LTS baseline has been selected (2.387)
FOSDEM this weekend
- Thanks to those going & representing Jenkins
Debian 12 without JDK 11
- OpenJDK 17 will be available for Debian 12 when it releases in April or May 2023
- OpenJDK 11 will not be available as a package for Debian 12
- Docs SIG has decided that beginning at the release of Debian 12,
  - Switch to document Linux installs with Java 17, not Java 11
  - Should we also change the Windows instructions at the same time?
    - Yes
- JDK 17 is already fully supported with Jenkins (has been since at least 2.346.1)
- Upcoming, Jenkins will eventually stop supporting Java 11
  - No date is set for end of Java 11 support
  - Not likely to drop JDK 11 until 2024
- Platform SIG asked, “Should we more clearly describe our use of Eclipse Temurin?”
  - Jenkins containers intentionally use Eclipse Temurin
    - Multi-platform, usable in all containers we support
    - Needs adding to documentation
      - Installation, blog post (?)
    - How to install JDK11 on Bookworm (Debian 12)
GSoC
- Application will be submitted in a couple days
- Project ideas have been updated to Published
- Mentor applications are still open at this time, will be closing soon
- Massive thanks to all the mentors and participants that have signed up already!
Pull requests of note
- Add updating Jenkins section in User's Handbook by Vandit1604 · Pull Request #5888 · jenkins-infra/jenkins.io · GitHub - “Updating Jenkins” guide update
  - Significant amount of work and content to add
  - 40+ minutes of review of the pull request in the office hours
  - Vandit’s work on this pull request is impressive. Great details and great content on a huge topic. We never expected that a new contributor would work on the upgrade guide and do such a good job
- Added a lighttpd reverse proxy example by hector-vido · Pull Request #5900 · jenkins-infra/jenkins.io · GitHub - adding Lighttpd reverse proxy info
  - Needs testing/verification before adding
- https://github.com/jenkinsci/docker/pull/1538 - Uninstalling a plugin from Docker container
  - Needs testing/verification
  - Will need discussion with Docker experts
  - May want it ultimately on www.jenkins.io
- Add Jenkinsfile Runner GitHub Action tutorial by Cr1t-GYM · Pull Request #5970 · jenkins-infra/jenkins.io · GitHub - adding Jenkinsfile Runner GitHub Actions tutorial
  - Completely new content, needs to be tested and verified
  - Follow up from GSoC ‘22 projects
- Update View Logs page in System Administration section by sujay2306 · Pull Request #5985 · jenkins-infra/jenkins.io · GitHub - Update “Viewing Logs” page
  - Content needs this update (mac OS X is a few versions behind)
  - Need to provide additional content/context for other systems (K8s, docker, etc)
    - Have shared the installing page as a good place to start for other systems, but not sure what else could be missing.
    - Free BSD
- Manage Users Documentation added by BhaswatiRoy · Pull Request #5980 · jenkins-infra/jenkins.io · GitHub - add managing users page content
  - Thanks to Bhaswati for taking the time to create this
  - No previous content, making sure that the manage users process is outlined
  - There will most likely be further content added as security and other aspects of managing users will need to be documented here.
- Add information about implied dependencies and detached plugin by Vandit1604 · Pull Request #5958 · jenkins-infra/jenkins.io · GitHub - add implied dependency information
  - Lots of good content submitted, have provided initial review & suggestions
  - Needs further review once changes are applied/added
  - Recommend screenshots for content about the plugin manager page/hovering over the uninstall button
  - Detached plugin documentation (do we need a section dedicated to detached plugins)
    - Windows WMI Agents (mentioned in PR content)
      - Resolved in Jenkins 2.386 and later
    - Tool installers
      - Oracle JDK tool
    - Software configuration management
      - Subversion
      - CVS
    - Authentication
      - PAM Auth
      - LDAP
    - Miscellaneous
      - External job type
      - Javadoc
      - Mailer
      - Antisamy markup formatter
    - Build tools
      - Maven
      - Ant
      - JUnit