Documentation office hours - August 9, 2024

2024-08-09T02:30:00Z

2024-08-09 (Asia)

Attendees:

  • Mark Waite
  • Kris Stern

Agenda

  • Contributor spotlight: Darin Pope ((July 30, 2024)
    • Published on time
    • Created by Alyssa Tong
    • Found several new candidates for contributor spotlight
  • Jenkins 2.452.4, 2.462.1, and 2.471 released with critical security fixes
    • Security fixes the big story
    • Several user experience improvements in addition to the security work
    • GZip improved performance
    • Startup time reduced by ~5 seconds with a JSON performance fix
  • Retiring the Chinese documentation site
    • A Chinese site that Mark Waite discovered https://www.jenkins-zh.cn/
    • Goal: Redirect all the existing Chinese language pages to their English equivalent
    • Basil Crow has offered to help with the redirect and the nginx / Apache mod_rewrite changes
  • Other Chineses language resources
  • Simplifying plugin maintenance - a case study
    • Review current state of an example plugin
      • Outdated minimum Jenkins version (based on plugin installation data)
        • 90% of installs of the most recent release are on Jenkins 2.426.3 or newer
        • Upgrade minimum Jenkins version to 2.426.3 (no more Java 8)
        • Use Jenkinsfile from the Jenkins archetype (test Java 21, stop testing Java 11)
      • Non-standard source code formatting automation
        • Enable spotless.check.skip true in pom.xml file, remove Intellij format settings
        • Format with mvn spotless:apply match with other plugins
      • Outdated wiremock test library
        • Replaced with most recent wiremock library release
      • Dependabot updates daily are too frequent
        • Process them weekly and keep current enough
      • No automated release when relevant changes arrive
      • Move changelog to GitHub releases
        • Enable release drafter (part of automated releases)
        • Move outdated changelog from documentation to point to an already tagged release
      • Remove branches that are already part of a newer branch
      • Enable GitHub automerge
      • Add scripted Pipeline tests?
        • Already some indications in PR-19
      • Add declarative Pipeline tests?