Documentation office hours - September 23, 2022

[MarkEWaite (Mark Waite)]

2022-09-23T02:00:00Z

2022 09 23 Docs Office Hours

2022-09-23 (Asia)

Attendees

• Mark Waite
• Meg McRoberts

Agenda:

• Action items

  • Mark - Archive docs mailing list, switch to community.jenkins.io for Docs SIG
    • Wait until November
  • 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)

  • Blog posts for DevOps World
    • Improve a plugin tutorial
    • iOS Unity build pipelines
    • Contributor Summit agenda
    • Java 11 performance
    • What’s next for the Jenkins user interface
    • 6 Can’t Miss Sessions
    • Plugin Health Scoring
    • Expanding open source in Africa
    • Android apps with Jenkins
    • Contributor Summit
  • Pull requests to documentation merged
    • Modernizing a plugin - Workshop preparation
    • 20+ plugins being prepared for the workshop

• 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
      • Candidate plugins in a worksheet sorted by various attributes
  • 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