Documentation office hours - August 11, 2022

2022-08-11T16: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
  • News
    • LTS 2.346.3 release this week
  • Google Summer of Code - Vihaan Thora
    • Pipeline steps doc generator issue is resolved
    • Move to Java 11 is complete
    • SCM step pipeline library docs now available, issue is resolved
    • Configuration file is now splitting sections into more useful components
      • Iterates the documentation and splits that item into the params folder
      • Removes those sections from the main docs and links to the page
        • New page rather than embedding the content into the existing page
        • MultiSCM had a copy of the GitSCM content, split reduces to single content
          • Deduplication for the win!
      • If a config entry mentioned has less than a threshold, it is not deduplicated
  • Jenkins 2.361.1 changelog, upgrade guide, and blog post
    • Fatih Digermenci has asked for a blog post that they can share on the Continuous Delivery Foundation blog. Copy from a www.jenkins.io blog post? Different content?
      • Fatih wants a higher level post
      • Evolution of Jenkins across multiple years of development
        • See Basil’s Java 11 blog post for a nice presentation of history
  • 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
    • Make sure
  • 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
  • Blue Ocean status statement has been added to more locations, such as plugin page
    • Docker hub page needs updating still for the blueocean container
    • Blue Ocean tutorial pages need this added (Kevin will be adding this in the next week)
  • Changelog entries from multiple repositories - Mark Waite
    • Mark ask the Jenkins developer list as a discussion topic
  • Hacktoberfest documentation contributions
    • Many places that need to convert docs from wiki to markdown
    • Intentionally exclude documentation wiki page conversion from Hacktoberfest (too much knowledge required)
    • Inclusive naming updates excluded due to too much knowledge required for success
  • Mark not in next week’s meeting (vacation)
    • Ask Damien Duportal to join as Zoom meeting host? Kevin will check with Alyssa as wel

I think i said it in the other topic. In my opinion, if all they do is provide a tutorial that says “apt install”, then they are not vendors just tutorial writers. If they, for example, do one click installs, or pre-packaged VMs, or something, that would be different.