[FM Discuss] Style Guide?

[Tomi Toivio]

2009/12/4 William Abernathy <william at inch.com>


> It seems to me that in the admittedly small sample of seven people who've
> opined on this issue so far, we're divided into two camps: those who use
> style guides and consider them a valuable resource, and those who do not use
> them, and regard them as instruments of oppression.


This is getting too polarized, just like internet discussions tend to
become. It seems more everybody agrees that a style guide would be nice. If
everybody thinks that it shouldn't be enforced as policy, then there
actually seems to be no disagreement?

I have been thinking that a FLOSS Manuals style guide would be nice and
would find it useful. I just think that it should not be compulsory for
writers to use a style guide. I believe enforcing the use of a style guide
would be an extra hurdle for many contributors, since not everyone would,
could, or should be a professional technical writer.

In this sense I agree with Adam: A style guide would be great but it should
not be compulsory unless the writer wants to use it.

-- 
Best Regards
Tomi Toivio
Open Source Coordinator
http://fi.flossmanuals.net/
tomi at flossmanuals.net
+358445488856
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.flossmanuals.net/pipermail/discuss-flossmanuals.net/attachments/20091204/77765280/attachment.htm>