Documentation office hours - July 2022

Community
,
6

2022-07-21T18:00:00Z

2022-07-21 (Europe) - Look & feel, Blue Ocean, Commercial support

Attendees

  • Mark Waite
  • Bruno Verachten

Recording:

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
  • News
    • Jenkins 2.360 released
      • New configuration page for Freestyle projects and other projects
        • Moves the navigation to the side panel from the top
        • Folders plugin does not have the change
        • UX SIG includes a demo
    • Google Summer of Code presentations today
      • Pipeline Steps Doc Generator - Vihaan Thora
  • Look and feel page improvements pull request
    • Looks ready to go
    • Need to coordinate the merge with Gavin Mogan so that we don’t disrupt the plugin site
      • Open for more feedback through a community.jenkins.io post?
      • Yes, and coordinate with Gavin on the final merge (Mark do it)
  • Blue ocean status message to embed in Blue Ocean docs pages
    • Pull request 5288
    • Sample site page
      • Placement of the message on the page?
      • Prefer it higher on the page, possibly after the very first paragraph
        • Create a strong first paragraph if one does not already exist
  • Search improvements for www.jenkins.io
    • Some searches on www.jenkins.io have very poor results
      • Search for “upgrade”
    • 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
        • Track progress in the GitHub issue
  • Other topics
    • Next LTS baseline will require Java 11
      • Baseline will be chosen next week, likely either 2.360 or 2.361
      • Supports Java 17
    • May need to cancel July 28 meeting
      • Mark attending Southern California Linux Expo (SCaLE 19x)
      • Kohsuke Kawaguchi attending as well, along with Alyssa Tong
      • Mark to cancel the meeting next week
  • 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
    • Weekly changelogs are generated by a script that creates entries from core pull requests
    • Packaging repository can provide important changes (like PR-325 support Java 17 in Windows installer)
    • Docker controller repository sometimes contributes important changes (like PR-1408 Replace install-plugins.sh)
    • Could we enhance the changelog generator to read the pull requests from packaging repository and from the Docker controller repository?
      • If we did, how would the changelog generator know which pull requests to include?
    • Mark ask the Jenkins developer list as a discussion topic
  • Jenkins 2.346.3 changelog and upgrade guide