discuss: To or not to Wiki, a summary [Was Re: small demo page]
Subject:
Re: [discuss] Re: To or not to Wiki, a summary [Was Re: small demo
page]
From:
Rahul Sundaram ####@####.####
Date:
24 Aug 2005 11:06:46 -0000
Message-Id: <430C54C2.10603@redhat.com>
jdd wrote:
> Machtelt Garrels wrote:
>
>>> http://fedora.redhat.com/participate/documentation-guide/sn-tech-docs-fundamentals.html
>>>
>>
>
> this is exactly the kind of doc I will _hate_ to read (the "tone"
> chapter), like if the writer had a stick in the ...
This is what good documentation is all about. Setting up guidelines and
expectations.
>
> I appreciate greatly humor and colloquial as well as opinions. For
> example it's _very_ important to know is an option is frequently used
> (ie must be perfectly know) or not (one can read the man page if
> necessary)
I appreciate humor and colloquialism too but they dont belong in
technical documentation
>
> about the gender, it's and endless problem. In french there no neutral
> gender, so anybody.thing is necessarily male or female. sometimes
> amusant, most of the time boring
>
> jdd
When you addressed someone in a in appropriate it, acknowledge it even
when you dont apologize for it
regards
Rahul