Update product design rituals (#34482)

+ Remove "🦢🚀🤝 Product Design + Frontend Engineering" ritual
+ Formalize the rituals for release docs: add post-sprint-kickoff,
pre-release, and post-release documentation tasks
This commit is contained in:
Rachael Shaw 2025-10-20 14:47:58 -05:00 committed by GitHub
parent b49e7826d4
commit 688f50b619
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 23 additions and 8 deletions

View file

@ -59,7 +59,7 @@ At Fleet, like [GitLab](https://about.gitlab.com/handbook/product-development-fl
4. If the story requires API or YAML file changes, open a pull request (PR) to the reference docs with the proposed design. Pay attention to existing conventions (URL structure, parameter names, response format) and aim to be consistent. Your PR should follow these guidelines:
- Make a PR against the docs release branch for the version you expect this feature to be in. Docs release branches are named using the format `docs-vX.X.X`, so if you're designing for Fleet 4.61.0, you would make a PR to `docs-v4.61.0`.
- Add a link to the issue in the PR description.
- Attach the `~api-or-yaml-design` label and add a milestone. (This helps us spot unmerged PRs.)
- Attach the `~api-or-yaml-design` label. (This helps the [API design DRI](https://fleetdm.com/handbook/company/communications#directly-responsible-individuals-dris) prioritize API/YAML PR review.)
- Mark the PR ready for review. (Draft PRs do not auto-request reviews.)
- After your changes are approved by the API design DRI, they will merge your changes into the docs release branch.

View file

@ -76,12 +76,6 @@
frequency: "Weekly"
description: "Review user stories in the 'In review' column on the drafting board with each product group's Product Designer, Engineering Mananger, and Quality Assurance Engineer."
dri: "noahtalerman"
-
task: "🦢🚀🤝 Product Design + Frontend Engineering"
startedOn: "2025-04-23"
frequency: "Triweekly"
description: "Product Designers and Frontend Engineers meet to discuss proposed changes to design conventions, UI components, and potential overlap/collisions between in progress wireframes."
dri: "rachaelshaw"
-
task: "Revise quarterly roadmap blog post"
startedOn: "2025-07-18"
@ -111,4 +105,25 @@
frequency: "Triweekly"
description: "Retro: What went well? What could go better? What to remember for next time?"
moreInfoUrl:
dri: "noahtalerman"
dri: "noahtalerman"
-
task: "Review reference docs for upcoming release"
startedOn: "2025-10-20"
frequency: "Triweekly"
description: "After sprint kickoff, check for unmerged API design PRs on the release docs branch (filter: is:pr is:open base:docs-vX.X.X). For stories that made it into the sprint, merge the PR. For stories that did not make it in, close the PR and @-mention the author."
moreInfoUrl: ""
dri: "rachaelshaw"
-
task: "Create release documentation PR"
startedOn: "2025-10-31"
frequency: "Triweekly"
description: "1. Close any draft PRs (to auto-generated docs) for released features. 2. Prepare documentation PR to `main`. 3. @-mention release DRI"
moreInfoUrl: ""
dri: "rachaelshaw"
-
task: "Update release documentation branches"
startedOn: "2025-10-31"
frequency: "Triweekly"
description: "After a release documentation PR is merged to `main`, merge the latest from `main` into each upcoming release docs branch."
moreInfoUrl: ""
dri: "rachaelshaw"