whiskeysierra/compass

Changelog vs. Version History

whiskeysierra opened this issue · 1 comments

Changelog

A changelog is a record of changes.

https://www.techopedia.com/definition/13934/changelog

(Comparable to diffs.)

Version History

A "version history" resource is a resource that contains all the
versions of a particular versioned resource.

https://tools.ietf.org/html/rfc5829#section-2

(Comparable to hard copies.)

Audit requirements would be satisfied with a changelog alone. A complete version history could be reconstructed from a full changelog but it would be more difficult to use. A version history could also be used by clients more easily since they are able to understand individual versions already (since they already work with the most current one by default).

Keeping hard copies of everything feels like the simpler thing to do. It's also more powerful and easier to use. Obvious choice.