Documentation office hours - Feb 2, 2023

[MarkEWaite (Mark Waite)]

2023-02-02T17:00:00Z

2023 02 02 Docs Office Hours

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
  • https://github.com/jenkins-infra/jenkins.io/pull/5888 - “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
  • Uninstalling a plugin #1531 by ritikbanger · Pull Request #1538 · jenkinsci/docker · GitHub - 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.
  • https://github.com/jenkins-infra/jenkins.io/pull/5958 - 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