Documentation office hours - August 12, 2022

2022-08-12T02:00:00Z

Attendees

  • Mark Waite
  • Meg McRoberts
  • Kris Stern

Agenda

  • Action items
    • Mark - Archive docs mailing list, switch to community.jenkins.io for Docs SIG
    • Upcoming blog posts that Mark owes to the organization
      • Award winners from cdCon
        • Darin Pope named CDF Continuous Enthusiast of 2022
        • Basil Crow named Jenkins Top Contributor
        • Wadeck Follonier Security MVP (Most Valuable Player)
        • Oleg Nenashev named CDF Top Documentor
      • Jenkins Contributor Summit summary
      • She Code Africa Contributhon results - done and posted to www.jenkins.io
  • News
    • Jenkins 2.346.3 LTS released this week
      • Broadcast “What’s new in 2.346.3” with Darin Pope and Mark Waite
  • Jenkins 2.361.1 (September) changelog, upgrade guide, and blog post
    • Kevin Martens has started the review process of changes since 2.346 baseline
      • Yellow highlighter on each of the items we should be included in the changelog
      • Backport section depends on what is selected for backporting
    • Kevin is assembling the upgrade guide
      • Reviews all pull requests submitted to the 2.361.1 baseline
        • Find the upgrade-guide-needed label, adds those entries to the guide
    • Changelog and upgrade guide usually available at least one week prior to release
      • Merged several days prior to the release
      • Not visible to users until the day of release (Sept 7, 2022)
    • Blog post
      • Require Java 11 and all that means - upgrade your agent JVMs, upgrade your controller JVM, check your evil job type (maven job type) and understand impact, etc.
    • Fatih Digermenci has asked for a blog post that they can share on the Continuous Delivery Foundation blog.
      • Consider a “history of Jenkins improvements”
        • Java 8
        • Tables to divs - 2.277.
        • UI improvements phase 1-4
        • Java 11
        • Java 17
        • Security enhancements (defensive security like agent to controller)
  • Google Summer of Code
    • Office hours yesterday with 3 contributors
    • All contributors are on track to complete by the deadline
    • All midterm evaluations completed and passed
    • Pipeline steps doc generator issue is resolved
    • Move to Java 11 is complete
    • SCM step pipeline library docs now available, issue is resolved
    • Configuration file is now splitting sections into more useful components
      • Iterates the documentation and splits that item into the params folder
      • Removes those sections from the main docs and links to the page
        • New page rather than embedding the content into the existing page
        • MultiSCM had a copy of the GitSCM content, split reduces to single content
          • Deduplication for the win!
      • If a config entry mentioned has less than a threshold, it is not deduplicated
  • Long-standing pull requests
    • Modernizing a plugin - prototype
      • Original document
        • Kevin Martens will be evaluating it and following the steps
      • Prototype tutorial pages
      • Need to be ready for DevOps World
    • 90 minute session at DevOps World on Adopting a plugin
      • Mark Waite leading, Bruno Verachten, Jean-Marc Meessen assisting
      • Consider including security recommendations from PR 4701
    • Security section restructuring
      • Needs review from Daniel Beck and security team
  • When do plugins need to be upgraded to drop Java 8 support?
    • When a plugin requires a Jenkins version that requires Java 11, then the plugin also requires Java 11
      • When the git client plugin sets its minimum Jenkins version to 2.361.1 or later, then the git client plugin requires Java 11 and can upgrade its internal copy of JGit from 5.13 to 6.2 or later