Documentation office hours - September 16, 2022

[MarkEWaite (Mark Waite)]

2022-09-16T02:00:00Z

2022 09 16 Docs Office Hours

2022-09-16 (Asia)

Attendees

• Mark Waite
• Meg McRoberts
• Kristin Whetstone

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
  • Mark out of the office Sep 26 - Sep 30, Oct 10 - Oct 27
    • Cancel Asia office hours during those weeks
• DevOps World 2022 (Sept. 27th - 29th)
  • Multiple blog posts for DevOps World
  • Pending pull requests to documentation
    • Modernizing a plugin progress report - Workshop preparation
      • Planned to merge Sep 21, 2022
      • Reviews welcomed and encouraged
• Hacktoberfest documentation contributions - Mark
  • Jenkins page for Hacktoberfest updated
  • Blog post arrived
    • Preparing good first issues
  • Starts Oct 1, 2022, ends Oct 31, 2022
  • Need a list of approachable documentation tasks (good first issues)
    • Two categories of www.jenkins.io Hacktoberfest topics
      • Good first issues - no Jenkins experience required
      • Hacktoberfest - Jenkins experience required
      • Need volunteers to review open issues and recommend labels
        • Propose to close issues that no longer make sense or are resolved
        • Good to spend time on this during Docs office hours
    • Plugin documentation migration to GitHub
      • See the migration report for plugins to be migrated
      • See the www.jenkins.io documentation that describes the task
        • Darin Pope and Mark Waite video demo of 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
      • More challenging to manage those types of contributions because they are submitted to many different repositories and Docs SIG members don’t have write access to those repositories
      • Improve a plugin developer tutorial will include a docs migration page
  • Tasks intentionally not recommended for Hacktoberfest
    • General documentation migration to GitHub
      • Not recommended for new contributors
      • We have a large backlog of wiki migration pull requests that are stalled because they require significant work from experienced users and administrators