Documentation office hours - Mar 3, 2023

Community
,
1

2023-03-03T03:00:00Z

Attendees

  • Mark Waite
  • Meg McRoberts
  • Freyam M

Agenda

  • Introductions
    • Freyam joins us today. CS student in India. Joined the Jenkins project planning to mentor a Google Summer of Code project (plugin installation manager tool). Was a GSoC 2021 contributor and a GSoC 2022 mentor at Joomla
    • Meg McRoberts. Technical writer has been with the Jenkins project 5+ years. Last year on observability in the Keptin and OpenFeature and OpenTelemetry open source projects
    • Mark Waite. Jenkins contributor, core maintainer, git plugin maintainer, documentation contributor, spent several years as the documentation officer
  • Action items
    • Mark Waite review and merge 2.387.1 changelog and upgrade guide
    • Mark Waite review and merge other long standing pull requests
      • Upgrade guide - Vandit Singh, needs further refinement and merge
      • Uninstalling a plugin - Docker repository, needs extension and copy into www.jenkins.io
  • LTS 2.387.1
    • Mar 8, 2023
    • Changelog & upgrade guide
      • Has screenshots for preview, noticed error in text of first screenshot (include instead of includes) and this has already been updated.
      • Urgent action item for Mark and others to review and merge
      • Alexander Brandes has reviewed, feedback applied
  • Documentation transition from Java 11 to Java 17 at Debian 12
    • April / May 2023 release of Debian 12 ⇒ transition install docs from Java 11 to Java 17
      • April 2023 is also end of life for Ubuntu 18, will want to remove it from docs
      • Java 17 is already supported, we’ll switch the instructions to use it as default
      • Java 11 will continue to be supported
    • Transitioning Windows and Linux install docs from Java 11 to Java 17 at that time
      • Consistent Java version
      • Move more users to Java 17
    • Have emailed Tim Jacomb to let him know about the transition, he responded saying it sounds good.
  • Improving end of life notifications
    • Ubuntu 18.04 reaches end of life April 2023, but no way to tell users that it is end of life
      • Consider how we would do that notification
      • Could be bundling a data file of operating system end of life dates with data from https://endoflife.date/
    • Container images that we want to stop supporting, but no way to tell users
    • Platform SIG discussing an administrative monitor that would display the content of one or more files from disc to announce end of life events that can be detected based on presence or absence of a file
    • Data files in a directory that could be used to state:
      • End of life (embed date in the file so that Jenkins can show the end of life is approaching and again show that the end of life has now happened)
      • Jenkins Enhancement Proposal needed to launch the idea and then we apply it to
        • Blue ocean container image
        • CentOS 7 container image
        • Archlinux agent container image
  • Prep for CentOS 7 end of life (proposal)
    • Mark Waite has strong bias against CentOS 7
      • Ancient command line git (1.8) - complicate Jenkins plugins (git)
      • Ancient SSH (7.4) - complicate Jenkins plugins (git)
    • CentOS 7
      • Maintenance mode since 2020
      • End of life June 2024
      • Already not supported by the Jenkins rpm installer
      • Already not maintained in its container image
    • Action items
      • Create one or more issues to track the work to remove CentOS 7 from docs
      • Stop running automated packaging tests of CentOS 7
      • Announce deprecation of CentOS 7 container images
      • Capture the end of life of CentOS 7 in a Jira epic
    • Mark propose a JEP to end support sooner
  • A 10 minutes into Jenkins guide
    • See the tutorials on www.jenkins.io
    • See the developer tutorials on www.jenkins.io
      • Improve a plugin tutorial that starts a new developer with small, but valuable improvements
  • Review plugin installation manager tool pull requests
    • Reviewed and merged