Documentation Office Hours - Sep 1, 2023

Community
,
1

2023-09-01T03:00:00Z

2023-09-01 (Asia)

Attendees

  • Mark Waite
  • Kris Stern
  • Ashutosh Saxena

Agenda

  • Blog posts
  • Google Summer of Code
    • Docker compose for easier and safer tutorials
      • Successfully completed!
      • 4 or 5 tutorials now execute with a single command
      • Remaining work
        • Create a docker container repository in jenkins-infra
        • Create a docker folder on Dockerhub
        • Create jobs to maintain those containers
          • Already maintenance configured, not yet running on ci.jenkis.io
    • Versioned documentation for Jenkins.io - Vandit Singh
      • Very near a working Antora site with versioned documentation
      • The Gatsby integration still needs some work
      • Abandoned the strapi backend idea for blog post review
      • Will simplify the process by using GitHub to review blog posts
      • Next steps
        • Focus on fixing Antora site links (most fixed, need another pass)
        • No automation to repair the links, will need to read the log files for links
          • Needs more study of the output and how it works
        • Some hope for later automation
        • Need to check the links interactively
      • Project may be able to complete all the planned milestones
        • Blog is easier now that we’re not using the strapi backend, stay with GitHub
    • GitLab plugin modernization
      • Interactive testing by Mark Waite has been delayed by work
        • Needs more testing, more comparison of old and new bnehavior
        • See the test outlines that are in the project meeting notes
      • Project has completed successfully
      • Harsh has agreed to continue as a plugin maintainer (that is first time a contributor became a maintainer)
    • Plugin health score
      • Discussions on Gitter related to an issue
        • Score calculation is flawed in some way
      • Adrien was working on code improvements that may help Jagruti’s work (if Mark remembers correctly)
      • Possible future action is on GitHub in an issue by Alex Brandes
        • One more probe that can be implemented
      • Jagruti mentioned on the third party repo probe again
        • There was an issue with how to detect the third party repositories
      • Need to check project documentation, may need additional documentation
        • Consider it for Hacktoberfest
  • How to describe the process of choosing a plugin bill of materials version
    • No progress since last week
    • Described in issue 2359
    • Consider using updatecli to update the version string explicitly in the documentation
    • Consider including static references to older versions in addition to the most recent release
    • Consider adding a blog post that highlights how to do it
  • Java 11, Java 17, and Java 21 discussion (see Google Doc from Mark Waite)
    • Discussion, next steps, etc.
    • More work needed, pictures to help explain
    • Mark show his picture (draft form)
  • Adding existing requirements/support policy documentation to System Administration section (new chapter/sections)
    • Diagnosing Kevin’s prototype - debug session
  • DevOps World Tour - Mark owes a blog post
    • Business benefits of contributing to open source - New York, Chicago, and Santa Clara - Mark Waite
    • Singapore - Olivier Lamy
    • London - Tim Jacomb