Aidan
(Aidan Heerdegen, ACCESS-NRI Release Team Lead)
2
I’d plump for a “Credits” section
Aidan
(Aidan Heerdegen, ACCESS-NRI Release Team Lead)
3
In the spirit of pedantry, I think I’d prefer “How to use” to “Getting started”. If someone is already using a released product and wants to update to the more recent version “Getting started” doesn’t seem as appropriate.
This is a musing more than anything. I’ve not even managed to convince myself, but thought it worth mentioning.
Aidan
(Aidan Heerdegen, ACCESS-NRI Release Team Lead)
4
In a similar vein, “Resources” instead of “Further Reading”?
Do we need a section for Test Results ? (optimistic, I know!)
Github links are good, but should we also have a gadi address (i.e. which module to use)
I think the sections should be more explicit:
i.e.
Limitations should have links to github issues and any known issues should be put into issues before the release is made
Link to github should be a link to the Github release
Aidan
(Aidan Heerdegen, ACCESS-NRI Release Team Lead)
6
Do we have a process for incorporating (or rejecting) suggested changes?
I’ve added “Known Issues” heading above the warnings in my first use of the template, as I think it is important to at least imply this might be something we will fix at a later date.
Aidan
(Aidan Heerdegen, ACCESS-NRI Release Team Lead)
7
Definitely also need a boiler-plate “How to get support” section.
I’ve added some of the suggestions to the template - I think this will be somewhat organic and change slightly for the specific release. We can re-evaluate as time goes on.
Aidan
(Aidan Heerdegen, ACCESS-NRI Release Team Lead)
9
I’ve modified to more closely reflect current usage. This includes adding a support section, changing the visibility of credits, and splitting the known issues and warnings.
We can change back or modify as required.
One formatting change was to use markdown titles. This has the advantage that it creates an anchor to that section so it can be linked to directly.
Aidan
(Aidan Heerdegen, ACCESS-NRI Release Team Lead)
10
I have reverted back to the version before the edits by @cbull, though I made a real hash of the and just ended up pasting in the text from the previous revision.