On 6 Nov 2007, at 18:53, Boris Ouretskey wrote:
Anyway to document large system it is obligatory to use wiki pages
(and a lot of time of cause) and give all the company an opportunity
to participate in the process.
Wiki? Obligatory??
I don't believe in wikis at all. I know there is (still) a lot of hype
around them, but I think it is a complete myth that they work. There
is somehow the wishful thinking that the documents (documentation, in
this case) write themselves. The hive-mind will fix it. "The
community" (or "all the company") will write it.
The result, much more often than not in my experience, is a document
that nobody takes responsibility for, that has very weak overall
structure, and random level of detail over various parts. No guarantee
that important information is represented appropriately at all.
I'd like to know who to kick if the document sucks.
Michael
----------------------------------------------------------------------
PPIG Discuss List (discuss@ppig.org)
Discuss admin: http://limitlessmail.net/mailman/listinfo/discuss
Announce admin: http://limitlessmail.net/mailman/listinfo/announce
PPIG Discuss archive: http://www.mail-archive.com/discuss%40ppig.org/