[Zope-dev] Changelog formatting [was: SVN: cmf.pt/trunk/ Preparing release.]

[Malthe Borch]

2008/12/21 Philipp von Weitershausen <philipp at weitershausen.de>:
> I've noticed you're using the U.S. date format here which we discourage due
> to its ambiguity (in this case it happens not to be ambiguous, but that's
> just coincidence). The preferred format is the ISO 8601 dash notation
> (YYYY-MM-DD).

Gotcha. I'll use this format in the future.

> This and other things, such as the proper formatting of changelogs, are
> documented in a guide called "Maintaining Software in the Zope Software
> Repository" [1] of which "Releasing Software" [2] is a chapter. I admit
> they're not in the most public place, I'm just the guy who wrote them (by
> codifying best practices). Anybody who'd like to put them somewhere more
> visible is most welcome to (e.g. the Grok folks have put the Releasing
> Software document on their website [3]).

I should review this material. I'm having some problems these days
formatting my changelogs.

\malthe