Re: time to retire ChangeLog?
Bruno Haible <[email protected]>
| Newsgroups | gmane.lisp.clisp.devel |
|---|---|
| Message-ID | <28616871.6I0nP0nqdD@omega> |
Hi Daniel, > I think a changelog is a very useful thing to have, but I always felt that > the one of CLISP is by far too detailed. > > Perhaps this [1] could give an inspiration how to keep a changelog that > only contains "important" changes. > [1] http://keepachangelog.com/en/0.3.0/ This kind of log is "for users and contributors to see precisely what notable changes have been made between each release (or version) of the project". In GNU, the NEWS file [2] serves this purpose. Whereas the ChangeLog [3] is for "people investigating bugs in the future". That's why it is so detailed. Bruno [2] https://www.gnu.org/prep/standards/html_node/NEWS-File.html [3] https://www.gnu.org/prep/standards/html_node/Change-Logs.html ------------------------------------------------------------------------------ Check out the vibrant tech community on one of the world's most engaging tech sites, SlashDot.org! http://sdm.link/slashdot _______________________________________________ clisp-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/clisp-devel