Boris Ouretskey
Tue, 06 Nov 2007 11:29:16 -0800
You are welcome to visit www.wikipedia.org and convince yourself that is far away from being myth.
-----Original Message----- From: [EMAIL PROTECTED] [EMAIL PROTECTED] On Behalf Of Michael Kцlling Sent: Tuesday, November 06, 2007 9:16 PM To: discuss@ppig.org Subject: Re: PPIG discuss: Documentation for large systems 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/ ---------------------------------------------------------------------- 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/