[FM Discuss] Style Guide? (Floss Manual Guide is involved enough?)

mp mp at aktivix.org
Fri Dec 4 05:21:39 PST 2009


The immediate question, to me, is: who will write the style manual for
the writing of the style manual?

On a more serious level: perhaps there could be some sort of way of
adding comments to the different manuals about the style used in that
particular manual. In that way there could maybe be an exchange and a
learning process about style, rather than some sort of central committe
style Scripture that tells people how to write.

With regard to professional writers: well, thank god that this is a
volunteer effort. The world has seen more than enough professionalism
and efficiency, I think.

-martin
(contributor of a little idiosyncratically written part of the Firefox
in Ubuntu manual)

dwp wrote:
> Hi: Some time ago when i first became acquainted with FLOSS, the first thing i ran across was an 80 page document that I think was intended to tell me how to write for FLOSS. Did/does it really have to be that complicated? For a while it discouraged me. 
> 
> I'm kindof with you. Style guides (besides sometimes being difficult to remember) stand in the way. I think there is even a guide that tells you haw to write manuals using only 800 "basic English" words:). Doubleplus ungood:). 
> 
> Regards: David
> _______________________________________________
> Discuss mailing list
> Discuss at lists.flossmanuals.net
> http://lists.flossmanuals.net/listinfo.cgi/discuss-flossmanuals.net
> 



More information about the Discuss mailing list