By a style guide, I mean a list of conventions that we agree to use,
for the sake of consistency,

It would cover things like:

1) When we refer to the user, do we refer to them in the 2nd person as
"you", or third person as "the user", or "the author"?

2) When we refer to Apache do we say "We" or "The Apache OpenOffice
project", e.g., "We welcome your bug reports" versus 'The Apache
OpenOffice project welcomes..."

3) Conventions for what text styles to use for text the user should
enter,  for referring to menu items, etc.

Many other similar things.

If we don't, maybe it would make sense to have a self-describing page
that does a little of everything, so we can illustrate the style to
new volunteers.

-Rob

Reply via email to