commit 38881173188209db0bb9dd40bacc48aa1883f5e4 Author: Roger Dingledine arma@torproject.org Date: Sun Aug 28 21:43:19 2011 -0400
add another heuristic for making release notes --- doc/HACKING | 9 +++++++-- 1 files changed, 7 insertions(+), 2 deletions(-)
diff --git a/doc/HACKING b/doc/HACKING index 9747f22..b0689d8 100644 --- a/doc/HACKING +++ b/doc/HACKING @@ -426,10 +426,10 @@ interesting and understandable. first entry or two and the last entry most interesting: they're the ones that skimmers tend to read.
- 2.4) Clean them up + 2.4) Clean them up:
Standard idioms: - "Fixes bug 9999; Bugfix on 0.3.3.3-alpha." + "Fixes bug 9999; bugfix on 0.3.3.3-alpha."
One period after a space.
@@ -446,6 +446,11 @@ interesting and understandable.
Present and imperative tense: not past.
+ Try not to let any given section be longer than about a page. Break up + long sections into subsections by some sort of common subtopic. This + guideline is especially important when organizing Release Notes for + new stable releases. + If a given changes stanza showed up in a different release (e.g. maint-0.2.1), be sure to make the stanzas identical (so people can distinguish if these are the same change).