On Wed, Jan 21, 2009 at 11:06:07PM -0800, Simon Michael wrote: > +1! I like the focus on readers.
Thanks; it's a tenet of technical writing to remember who your target audience is, which is why I tend to state it up-front. > 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. OK, I'm not too worried about that. I think the sort order is mostly the same either way for this release :-) _______________________________________________ darcs-users mailing list [email protected] http://lists.osuosl.org/mailman/listinfo/darcs-users
