Re: [CSSWG] Minutes and Resolutions 2011-09-28

On 09/28/2011 11:45 PM, Anne van Kesteren wrote:
> On Thu, 29 Sep 2011 03:18:25 +0200, fantasai <fantasai.lists@inkedblade.net> wrote:
>> - RESOLVED: Future documents need Changes sections before publication.
>
> The full minutes do not detail what is wrong with the version history of the document.

It's primarily useful for the OCD. :) The CVS changelogs are in some
ways too detailed--you get all the changes, including minor improvements
in wording, rearrangements of sections, changes to white space, typo and
syntax error fixes, etc--and in others lack enough detail--the commit
messages are not always very descriptive, and in some cases a change might
be misclassified under the wrong checkin. (I've seen substantive changes
go in under comments like "fix validation error".)

The Changes section distils what's changed and where to review the new
stuff into something more easily digestible for people who don't have the
time, patience, and dedication to follow every single checkin.

~fantasai

Received on Thursday, 29 September 2011 20:34:15 UTC