Documentation office hours - September 8, 2022

2022-09-08T17:00:00Z

Attendees

  • Mark Waite
  • Kevin Martens
  • Vihaan Thora
  • Bruno Verachten

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
    • Upcoming blog post for Digital Ocean sponsorship - Kevin
  • Google Summer of Code - Vihaan Thora/Mark

    • 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 is being updated (Basil & Mark)
  • Jenkins 2.361.1 (September 7, 2022) changelog, upgrade guide, and blog post

    • Released yesterday
    • 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)
    • 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
  • Commercial support page proposal

    • Prototype shown by Gavin
    • Update support page to provide better content/direct contact to support
    • Need more data from vendors for the prototype
      • May want to ask the Outreach SIG to contact potential vendors
    • Discuss further adding cloud providers to the commercial vendors
      • They are not commercial support vendors, but are commercial vendors
      • Raise the question to the community forum, discuss there