[darcs-users] darcs patch: Use conventional name "NEWS" for "new in... (and 2 more)

Simon Michael simon at joyful.com
Thu Jan 22 07:06:07 UTC 2009


+1! I like the focus on readers.

Trent W. Buck wrote:
> - Try to keep each point one line long.  To this end (and because end
>   users probably don't care) I have deleted the attributions and
>   rewritten some entries.  If a point spans multiple lines, add a
>   blank line after it.

No big deal, but maybe I'd just keep the spacing consistent (no blank 
line). reST can handle it either way.

> - Points are sorted in (approximately) descending order of importance,
>   except that multi-line points get pushed to the bottom of the list.

I wouldn't do that, if a thing is super-important I expect to see it at 
the top of the list and don't mind if it takes multiple lines.



More information about the darcs-users mailing list