Documentation office hours - September 9, 2022

2022-09-09T02:00:00Z

Attendees

  • Mark Waite
  • Meg McRoberts

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
  • Google Summer of Code - Mark Waite

    • Pipeline steps doc generator reduced sizes is live on www.jenkins.io
    • Coding period ended
    • Late September online meetup to highlight the results
      • 4 projects all looking good
    • Steps on JSON asciidoc
      • Plugin HTML not correct, URL tags not correct
        • Mark, Bruno, or Kevin submit the repair pull request to the plugin
      • Done manually
      • Potential way to automate
  • Other tooling - Mark

    • Other improvements happening in docs tooling
      • Backend extension indexer updated (Basil & Mark)
      • Extension page lists 80 extension point providers before update
        • New page has over 120 extension point providers
  • Jenkins 2.361.1 (September 7, 2022) changelog, upgrade guide, and blog post

    • Released Wednesday
    • Successful release
      • websocket issue reported, investigation occurring
    • Live stream today with Darin Pope and Mark Waite
  • Jenkins 2.361.2 release lead requested in Developer Mailing List

    • Kris Stern has expressed interest in being release lead once again
    • Planned release date: October 5th 2022
  • DevOps World 2022 (Sept. 27th - 29th)

    • Pending pull requests to documentation
      • Modernizing a plugin progress report - Workshop preparation
        • Kevin is currently executing tutorial on Dynamic Search View plugin
        • Reviewing and providing feedback on pull request for tutorial
        • Mark, Jean-Marc, and Bruno have adopted 25+ plugins
        • Applying improvement steps to those plugins in an “answer book” repository
        • Workshop attendees will choose and improve a plugin, refer to the answer book when they encounter issues or surprises
        • After workshop, either contributor changes or answer book changes will be submitted and merged
        • Use the same tutorial for Jenkins in Hacktoberfest
  • Hacktoberfest documentation contributions - Mark

    • Site just went live https://hacktoberfest.com
    • Starts Oct 1, 2022, ends Oct 31, 2022
      • See pull request revising the “Participate” page for documentation
    • 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
    • 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
  • Backend extensions indexer

    • Reviewed the concept