Skip to content

Instantly share code, notes, and snippets.

@zacharysarah
Last active May 30, 2018 20:32
Show Gist options
  • Save zacharysarah/c7dfb90fe1d48762f48d8d6cbb0040b2 to your computer and use it in GitHub Desktop.
Save zacharysarah/c7dfb90fe1d48762f48d8d6cbb0040b2 to your computer and use it in GitHub Desktop.
Docs release meister for K8s 1.11

Handing over the release meister role

Thanks for taking on the release 1.11 release meister role for K8s SIG Docs!

Things to do

  1. Open a PR to update the official release team doc: https://github.com/kubernetes/sig-release/blob/master/releases/release-1.11/release_team.md.

  2. Introduce yourself to the 1.11 release lead, Josh Berkus (@jberkus on Kubernetes Slack).

  3. Start attending SIG Release meetings (currently weekly, Mondays 11am Pacific, cadence will accelerate as release progresses).

  4. Manage the release branches.

    I recommend updating release-1.11 as soon as possible, and working with people who've already opened PRs against the branch to get them aligned with the new content tree post-Hugo migration.

    I also recommend delaying updates to release-1.10 until we've done as much work as possible to bring the Reference page back into alignment with 1.10 organization. Until we re-add all of the APIs to master, docs on release-1.10 are the only available API reference for users.

Docs to track

Top priority

Reference as needed

Docs playbook

Original GDoc source (@chenopis): https://docs.google.com/document/d/1PCkAwPWadlu7beprhtQLtZzgsbO8CD7SvMVzta3fhcw/edit?ts=5963ce05&pli=1#heading=h.xh7s5vn5jum9

Current source (@bradamant3): https://github.com/kubernetes/sig-release/blob/master/release-process-documentation/documentation-guides/update-release-docs-new.md

PR in progress (@zacharysarah): https://github.com/kubernetes/sig-release/pull/139/files

Missing pieces

  • Remember that docs version strategy is CURRENT+4: for 1.11, supported versions will be 1.11-1.7
  • Update the version selector in every supported branch (release-1.<X>)
@mdlinville
Copy link

mdlinville commented May 15, 2018

To update the version selector, edit the config.toml, copy-paste the newest entry, and change the numbers. It looks like you also need to change the latest key and the docsbranch key, in the WIP release branch's copy of the TOML file.

@mdlinville
Copy link

mdlinville commented May 15, 2018

Release meister must be an approver in the OWNERS file too (in order to be able to approve PRs for merge)

Release meister needs to be added to the Github repo's admins group by another admin, to be able to force-push branches

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment