Documentation office hours - Jan 19, 2023

[MarkEWaite (Mark Waite)]

2023-01-19T18:00:00Z

2023 01 19 Docs Office Hours

2023-01-19 (EU/US) - JDK 17, UBI 9, detached plugins

Attendees

• Mark Waite
• Kevin Martens
• Bruno Verachten

Agenda

• Action items
  • Kevin - Archive docs mailing list, switch to community.jenkins.io for Docs SIG
    • Complete: Jenkins docs gitter is the main conversation area, with community.jenkins.io being available for larger/more involved discussions and topics.
  • Blog posts to highlight
    • 2022 Recap post
    • Jean-Marc Messen’s blog for Google Summer of Code mentorship
• Weekly 2.387 release successful
• Next LTS: February 8 2023
  • Changelog & upgrade guide added to LTS checklist
• Debian 12 (“bookworm”) will deliver OpenJDK 17, will not deliver OpenJDK 11
  • Debian 12 is planned for release in 2023
  • Jenkins impact
    • Affects Linux installation instructions
    • Does not affect containers (already use a different JDK)
  • Docker container addition of Red Hat universal base image (UBI) 9 with Java 11
    • Proposing to have them use Java 17
• Archive ‘WEBSITE’ component on Jira, focus on Github issues - complete
• 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
• Detached plugin documentation (do we need a section dedicated to detached plugins)
  • Windows WMI Agents
  • 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/pull/5888 - “Updating Jenkins” guide update
    • Significant amount of work and content to add/update
  • 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
  • https://github.com/jenkins-infra/jenkins.io/pull/5919 - pipeline syntax update for parameters
    • Some of the suggested content would fit better on a different page, such as a page for parameters themselves.
    • What other updates/additions would be good to ensure are included?