Skip to content

Commit

Permalink
New Product design responsibility
Browse files Browse the repository at this point in the history
Prepare reference docs for release
  • Loading branch information
noahtalerman committed Sep 20, 2024
1 parent d7594d1 commit f1b758c
Showing 1 changed file with 9 additions and 0 deletions.
9 changes: 9 additions & 0 deletions handbook/product-design/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -191,6 +191,15 @@ available in Google Drive.

Some of the data is forwarded to [Datadog](https://us5.datadoghq.com/dashboard/7pb-63g-xty/usage-statistics?from_ts=1682952132131&to_ts=1685630532131&live=true) and is available to Fleeties.

### Prepare reference docs for release

Every change to how Fleet is used is reflected live on the website in reference documentation **at release day** (REST API, config surface, tables, and other already-existing docs under /docs/using-fleet).

To make sure this happens, first, the [DRI for what goes in a release](https://fleetdm.com/handbook/company/communications#directly-responsible-individuals-dris) @ mentions the [API design DRI](https://fleetdm.com/handbook/company/communications#directly-responsible-individuals-dris) in a message in #help-engineering Slack channel when we cut the release candidate (RC).

Next, the API design DRI reviews all user stories with the release milestone to check that all reference doc PRs are merged into the reference docs release branch. To see which stories were pushed to the next release, and thus which reference doc changes need to be removed from the branch, the API design DRI filters issues by the `~pushed` label and the next release's milestone.

To signal that the reference docs branch is ready for release, the API design DRI opens a PR to `main`, adds the DRI for what goes in a release as the reviewer, and adds the release milestone.

## Rituals
<rituals :rituals="rituals['handbook/product-design/product-design.rituals.yml']"></rituals>
Expand Down

0 comments on commit f1b758c

Please sign in to comment.