Re: svn commit: rev 2653 - trunk/www trunk/doc/handbook

Blair Zajac <blair@orcaware.com> writes:

> Is the handbook open for commits?

Absolutely. I was a bit zealous about getting the "first draft" done
by just one or two people, for consistency and readablity. But I have
no more pending changes. At this point, we should treat it like
open source code. It should change as subversion changes.

> I noticed that there's inconsistent usage of @file, @samp and @url
> throughout the document with different people using different
> standards, i.e., file's are mentioned but not placed in @file{},
> other @samp's enclose sample URLs that could be changed to @url,
> etc.
>
> Is this worth changing to get consistent?

Definitely! This is the big risk of allowing many, many people to
patch it. Well, not really a "risk", but yes, we should be reviewing
those commits more carefully, trying to ensure consistent tag style.
Just as we have a coding style, we should make sure people are using
texinfo tags consistenly as well.

Please fix the problems you see... your points above are definitely
things worth fixing.

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@subversion.tigris.org
For additional commands, e-mail: dev-help@subversion.tigris.org
Received on Tue Jul 23 22:02:12 2002