> It *can* be.  Which doesn't mean that it is.  You know and I know and 
> everyone here knows that the process is often out of sight, out of mind. 
>  How many docs are there now on mozilla.org that were put up half done 
> and are still half done *years* later.

But that's a matter of manpower, not one of process. An r=/sr= system would mean those 
documents would instead by stuck somewhere on someone's hard drive.
 
>> - bad documentation (while it's still in development) hurts no-one
> 
> Depending on how you define "hurts" I don't think this is true.  The 
> people most likely to *read* the docs are the ones who need the 
> information, not the ones who already know it and want to make sure that 
> what's written in the doc is right.  And getting the wrong information 
> can make a body miserable.

It can be marked as "unreviewed (in a peer-review sense) perhaps. We definitely need a 
document state _tagging_ system.

>> - Docs can be changed at any time by anyone who sees a mistake
> 
> The problem, of course, is deciding what constitutes "a mistake".

It's surely more clear in technical documentation than it is in a novel :-)
 
Gerv


Reply via email to