Documentation office hours - September 22, 2022


2022-09-22 (Europe)


  • Mark Waite
  • Kevin Martens
  • Bruno Verachten


  • Action items

    • Mark - Archive docs mailing list, switch to 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
      • Not happening - drop this action item
    • Blog post for Digital Ocean sponsorship - Kevin
      • Published on Monday, 19th
    • Hacktoberfest 2022 prep-tember blog written by Jean-Marc
    • Adopt and improve a plugin tutorial published Sep 21, 2022
  • DevOps World 2022 is next week (Sept. 27th-29th)

    • With everyone going to DevOps World, next week’s docs office hours is canceled
      • Have already shared this news with Asia docs office hours
  • 2.361.2 changelog and upgrade guide

    • 2.361.2 release Oct 5, 2022
    • No upgrade guide at this time, as no changelog entries require it
    • Open for feedback and suggestions
  • Monday reviews of weekly changelog needed

    • Review before release day, note corrections needed
    • 2.370 was a security release, so next is 2.371
    • Kevin - will review while everyone is at DevOps World
  • Hacktoberfest documentation contributions - Mark

    • Jenkins page for Hacktoberfest updated
    • Need a list of approachable documentation tasks (good first issues)
    • Plugin documentation migration to GitHub
      • See the migration report for plugins to be migrated
      • See the documentation that describes the task
      • First choice - plugins that Mark, Jean-Marc, and Bruno have adopted
        • Know the reviews will happen, include those plugins in the list
      • Second choice - ask maintainers to review
        • Only include plugins if maintainers agree to review pull requests
          • Mark, Bruno, and Jean-Marc plugins have some need for docs
        • Candidate plugins in a worksheet sorted by various attributes
          • Submit bug reports to 20 most recently released plugins
            • Flag bug reports as good first issues with links to the instructions that describe how to migrate docs
            • Include plugins if maintainers agree to review pull requests