tianshou icon indicating copy to clipboard operation
tianshou copied to clipboard

Change log is chaotic and partly uninformative

Open opcode81 opened this issue 9 months ago • 2 comments

Changes pertaining to the same component are not grouped. I would recommend a more hierarchical change log, where we group all changes according to the function/module/class they pertain to. The first change in a component establishes a bullet item and further changes in the same component change the entry to use sub-items. This will make it much easier for a reader to determine which changes are relevant to them.

Some changes would benefit from a more detailed description. Reviewers should require good descriptions from contributors.

v1.0.0 should probably appear in the change log along with the release date.

We should also make clear that the topmost version is unreleased for clarity, i.e. "v1.1.0 (unreleased)", and then add the actual date once it's released.

opcode81 avatar Apr 29 '24 20:04 opcode81

I structured it a bit in this commit

MischaPanch avatar May 05 '24 14:05 MischaPanch

Noticed too late that you also structured it on another branch :(. Gonna clean up the conflict

MischaPanch avatar May 05 '24 14:05 MischaPanch