| Summary: | Split release notes into two documents, 'Technical release notes' and 'End user release notes' | ||
|---|---|---|---|
| Product: | Project Infrastructure | Reporter: | Martin Renvoize (ashimema) <martin.renvoize> |
| Component: | Release tools | Assignee: | Jonathan Druart <jonathan.druart> |
| Status: | CLOSED WONTFIX | QA Contact: | |
| Severity: | enhancement | ||
| Priority: | P5 - low | CC: | andrew, fiona.borthwick, jonathan.druart, kelly, nick, tomascohen |
| Version: | unspecified | ||
| Hardware: | All | ||
| OS: | All | ||
| GIT URL: | Initiative type: | --- | |
| Sponsorship status: | --- | Comma delimited list of Sponsors: | |
| Crowdfunding goal: | 0 | Patch complexity: | --- |
| Documentation contact: | Documentation submission: | ||
| Text to go in the release notes: | Version(s) released in: | ||
| Circulation function: | |||
|
Description
Martin Renvoize (ashimema)
2020-11-17 09:45:46 UTC
I'm happy to take on adding this to the release tools if people are interested in such a change I think it's good to have everything listed at the same place. I like the way we did for 20.05, with a dedicated section for the technical stuffs. However we should maybe highlight a bit more what important (actually we already have the notes for that). I'm torn on this. When we go through the release notes to prepare to upgrade our partners there are always one or two bugs that get listed as "Architecture, internals, and plumbing" but have really profound end-user implications. I'd worry that further splitting the notes would make those things even easier to miss. Perhaps some bugs warrant inclusion in both sets... I'm just trying to work out how we can better highlight the 'interesting' bits to the various parties without having to distract them by all the less interesting bits. I already tried to improve some of those important points by adding in semi-standardised notes for features that include new sysprefs, changes to reports and updated configs and script flags... though could really do with some help getting those in place for the next release.. it ended up a bit of a one man task the last couple of cycles. |