Documentation office hours - Jan 20, 2023

[MarkEWaite (Mark Waite)]

2023-01-20T03:00:00Z

2023 01 20 Docs Office Hours

2023-02-20 (Asia) - PR reviews: Site UI, Upgrade

Attendees

• Mark Waite
• Meg McRoberts

Agenda

• Action items
  • None
• Debian 12 (“bookworm”) will deliver OpenJDK 17, will not deliver OpenJDK 11
  • Debian 12 is planned for release in April or May or June 2023
  • Jenkins impact
    • Affects Linux installation instructions
      • Describe Java 17 install instead of Java 11
    • Does not affect containers (already use a different JDK)
      • Eclipse Temurin continues to support Java 11 and works on Debian
  • Docker container addition of Red Hat universal base image (UBI) 9 with Java 11
    • Proposing to have them use Java 17
• Handling regressions on the jenkins.io site
  • Some examples of regressions
    • Jumbotron no longer rotates - Jenkins root page - Jumbotron no longer rotates panels · Issue #5911 · jenkins-infra/jenkins.io · GitHub
    • Sponsors images wrong sized - FIX: Nonexistent scaling of jumbotron images breaks layout by Vandit1604 · Pull Request #5909 · jenkins-infra/jenkins.io · GitHub - merged
  • Use the same process for jenkins.io as Jenkins core
    • If a significant regression is not resolved promptly, then revert the change
    • Already followed that pattern with earlier changes
    • New labels created for jenkins.io (regression, major-regression)
  • Add to contributing guide when the plan is finalized
    • Meg agrees that this is a good plan
• Detached plugin documentation (do we need a section dedicated to detached plugins)
  • Windows WMI Agents
    • 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
• Pull requests of note
  • https://github.com/jenkins-infra/jenkins-io-components/pull/54
    • slight ui upgrade to jenkins.io
    • Approved by Mark and Meg, noted in pull request
  • https://github.com/jenkins-infra/jenkins.io/pull/5888 - “Updating Jenkins” guide update
    • Significant amount of work and content to add/update
    • 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
    • May need discussion with Docker experts

May want it ultimately on www.jenkins.io