Skip to content

Graphical view of release workflow(s)

Moved from the EDP repository; this belongs in the handbook

Issue/Problem Description

  • It's a bit hard from the doc to understand which workflow a release can use and what are the steps involved in term of approval. Understanding what a release involves requires moving in multiple places of the document and reading a lot of text, many of it being conditional, making it harder to sort out what's the path for a given case.

Proposal

  • I suggest we show on the EDP a graphical view of the workflow(s) for releases. If there is actually no flow, but just a list of independent requirement, we should show the checklist for each review explicitly.
  • The EDP release process could be an appendix, just like the IP Due Diligence poster which is extremely good for IP concerns (that I believe happen to be harder on paper, but easier to undersand thanks to the poster)

Proposal Benefits

  • People understand release process better and can better pick the right kind of release they need according to their project constraints.

Challenges

  • If it's an appendix, no immediate challenge.
  • If we're likely to update the process often, then having an extra document could be an additional maintenance effort and a risk of out-of-date content.

/cc @mistria