[#12048] Update changelog docs and changelog name

TEAMMATES / teammates

This is the project website for the TEAMMATES feedback management tool for education

https://teammatesv4.appspot.com/

GNU General Public License v2.0

1.64k stars 3.26k forks source link

[#12048] Update changelog docs and changelog name #13062

Closed NicolasCwy closed 2 months ago

NicolasCwy commented 2 months ago

Part of #12048

Context Previously I mentioned that liquibase runs changelogs in alphanumeric order, but this is incorrect. Changelogs are run in alphabetical order if the includeAll tag is used to run changelogs. In Teammates, we use the include tag which runs in the order they are placed in the changelog-root.xml file

Outline of Solution

Amend documentation to remind devs to add newest changelog to bottom of file.
Rename changelog name and tag name

Note: I'll update the Teammates Ops process which is more critical

NicolasCwy commented 2 months ago

Although the changelog sorted by name is

db.changelog-v9.0.0.beta.1
db.changelog-v9.0.0.beta.11
db.changelog-v9.0.0

The changelog executes in the order following the changelog-root.xml

db.changelog-v9.0.0
db.changelog-v9.0.0.beta.1
db.changelog-v9.0.0.beta.11

Images

Sorted by file name

Include order in changelog-root.xml