Documentation office hours - August 4, 2022

Community
,
1

2022-08-04T06:00:00Z

Attendees

  • Mark Waite
  • Bruno Verachten
  • Kevin Martens

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
      • She Code Africa Contributhon results
        • Blog post started today
  • Google Summer of Code - Vihaan Thora
    • Open issue to reduce size of some plugin pages in steps reference page
    • Reducing page size especially for the really huge pages
    • Considering alternate approaches
      • Iterating strings rather than Java objects
    • Deprecated label added
    • Run the docs generator for Vihaan’s updates 2.362 available
  • Look and feel page improvements pull request merged
    • Suggestion from Daniel Beck to revert the changes
    • Fixes from original submitter in new pull request
    • Shall we rollback and try again or push forward and adapt to issues?
  • Blue ocean status message in the Blue Ocean docs pages
  • Search improvements for www.jenkins.io
    • Some searches on www.jenkins.io have very poor results
      • Search for “upgrade” , don’t find the upgrade guides
    • Our use of Docusearch by Algolia needs to upgrade from the legacy scraper
      • Need some time to follow their directions, reconfigure the site to use new format
      • Any way to evaluate the change from legacy scraper to new system
        • Valid question
      • Mark to create a jenkins.io issue for this upgrade
  • Next LTS baseline will require Java 11
    • Baseline likely 2.361 (see the baseline selection email thread)
    • Supports Java 17
    • Upgrade guide content gathering should start
    • Changelog creation should start
  • Commercial support page proposal
    • Prototype shown by Gavin
    • Update support page to provide better content/direct contact to support
    • Mark submitted an additional data item for another vendor
    • 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
  • Changelog entries from multiple repositories - Mark Waite
    • Mark ask the Jenkins developer list as a discussion topic
  • Jenkins 2.346.3 changelog and upgrade guide
    • LTS Checklist is open for 2.346.3
    • PR for 2.346.3 upgrade guide and changelog
      • Includes backports that were approved and merged as of this week/last week
  • Tooling updates for Java 11
    • Pipeline steps doc generator already running with Java 8 (will be updated to 11)
    • Extension indexer pull request proposed to migrate from Java 8 for Java 11
      • Needs testing and impact assessment
  • Issue detected that Pipeline steps no longer includes scm step documentation