[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Modifications of the changelog.



Ben Finney <ben+debian@benfinney.id.au> writes:
> Charles Plessy <plessy@debian.org> writes:

>> are there concrete problems caused by modifying previous changelog
>> entries ?

> Doing that breaks the entirely reasonable expectation: that a changelog
> only ever accumulates entries for the latest release, and nothing in
> earlier releases has changed since the last time the recipient read
> them.

I think the absolute prohibition takes things a bit too far.

The changelog is documentation, and therefore can have bugs, just like any
other documentation.  If there is a bug, such as a missing entry for a
change that was made in an earlier version, I fix it like any other bug:
correct the changelog for that version, and add a note in the changelog
for the most recent version that I fixed the documentation bug.

-- 
Russ Allbery (rra@debian.org)               <http://www.eyrie.org/~eagle/>


Reply to: