Re: changelog format

[Thien-Thi Nguyen]

() address@hidden (Karl Berry)
() Thu, 24 May 2012 22:43:48 GMT

   I am not enthused about the term change set, but I have nothing
   better to suggest.

       A single change log entry corresponds to a change set, which
       comprises one or more individual changes.

   Should be no problem, since that has always been the intent.  So
   you're just talking about clarifying wording here.

Yes, exactly.

       5 -- (in line with 3, dependent on 4) Encourage "moderate" reference

   I don't know about any standardized format, since packages handle bug
   reports in soooo many different ways.  For example, [...]

   [...] a unique id that is easily located (much more easily than the
   message-id), but is hardly anything that should be standardized.

Yes, i agree "standardized" is not the right idea.  The right idea is
"URIs should have surrounding angle brackets and other references should
be written in a consistent (project-specific) way, with all ref targets
selected for permanence and uniqueness, the motivation being unambiguous
deref".

   Yes, I think that is the best way forward.

Cool.