In article <[EMAIL PROTECTED]>, Chris Fedde
<[EMAIL PROTECTED]> wrote:
> On Wed, 30 Jan 2002 22:49:28 -0600 _brian_d_foy wrote:
> | furthermore, since many of the differences i fixed were matters of
> | style, should we have a style guide for the documentation?
> We can make the style be "whatever passes _bryan_d_foy's script".
^
|
and people wonder why i have a style guide :) -+
> Do you think that is fair?
well, my script just builds perlfaq.pod. it doesn't check anything for
style, and i'm not about to write such a beast :)
in style, i mean things like:
* consistent use of punctuation (e.g. are we using a series comma or not?)
* agreed upon use of certain words (e.g. regexps or regexes?)
* some sort of notion of voice, person, and tense (e.g. active voice,
first person, present) unless something else is appropriate (e.g. things
in the past don't use the present tense ;)
and so on. i don't pretend that a right answer exists, but whatever we choose,
IMO, should be used consistently. we've been hacking at this on a per question
basis lately and it's starting to show. :)
