Documentation office hours - Jan 31, 2022

[MarkEWaite (Mark Waite)]

2022-02-01T02:00:00Z

2022 01 31 Docs Office Hours

Participants

Mark Waite (@MarkEWaite), Dheeraj Singh Jodha (@dheerajodha) , Meg McRoberts, Kristin Whetstone

Notes

• News
  • Weekly release planned for tomorrow, includes many changes
  • Chance it may be delayed one day for further changes
    • Some of the changes may be LTS backport candidates
  • LTS 2.319.3 scheduled for 9-10 days from now
  • GSoC project ideas and mentors are recruiting
• Changing from Tuesday to Friday for this meeting?
  • Google Summer of Code office hours scheduled Friday 3:00 AM UTC
  • Mark Waite needs to be in both, propose moving Docs office hours from Tuesday 2:00 AM UTC to Friday 2:00 AM UTC
  • Approved - Mark update the calendar and www.jenkins.io with the change
• Weekly changelog review
  • 6231 - needs links split into references after release, and move to the end
• Google Summer of Code office hours this week
  • What discussions are allowed in the meeting?
    • Candidates can discuss ideas, review topics, etc.
    • Could show a demo in the office hours (atypical, but allowed)
• She Code Africa Contributhon
  • Project ideas posted to community.jenkins.io
    • Inclusive naming updates for popular plugins
      • Script security
      • Mailer
      • Credentials
      • JUnit
      • …
    • Screenshot updates for docs using 2.332.1 or later
    • Test the tutorials and report issues with the tutorials
    • Test automation improvements - convert JUnit 3 tests to JUnit 4
• Linux installers switching from System V init to systemd
  • Documentation pull request submitted
  • Good opportunity to review the documentation and consider additions
    • See packaging pull requests from Basil Crow
• Open PRs
  • https://github.com/jenkins-infra/jenkins.io/pull/3392
    • urwa asked whether she should update on 1 June 2020 and got no answer.
    • Mention of Migrate 'ProcessTreeKiller' from wiki #3321 by LarrySul · Pull Request #3364 · jenkins-infra/jenkins.io · GitHub and changing a link after it is merged, which it is not.
    • Oleg suggests that this should be part of User Guide
    • Meg made editorial suggestions to tighten the prose and only have one sentence per source code line.
  • Migrate 'Unit Test' to jenkins.io developer docs by LarrySul · Pull Request #3385 · jenkins-infra/jenkins.io · GitHub – It looks like this is being worked after sitting around for a long time. Is it under control?
  • added agents with win scheduler content from wiki by urwa · Pull Request #3381 · jenkins-infra/jenkins.io · GitHub – A flurry of activity in May-June 2020 and now it seems dormant. This affects book/managing/nodes.adoc that has had some work since this PR was filed. Can we rebase this against the current content? I think this is a niceis nice addition to what is there.
  • https://github.com/jenkins-infra/jenkins.io/pull/2642 - It looks like Oleg filed a blocking comment that has been resolved. Meg did a bunch of word-smithing suggestions in November 2021, including some comments about broken links that are apparently no longer broken. We have merge conflicts but what would it take to get this merged?
    • Identify screenshots to be updated
  • https://github.com/jenkins-infra/jenkins.io/pull/4693/ – Meg went off the rails here but let’s figure out what we want and then she can fix.
  • https://github.com/jenkins-infra/jenkins.io/pull/4693/ – Waiting for Daniel