<br><tt><font size=2>>So, its up to you<br>
- use PmWiki more,<br>
- use the mailing list less<br>
- write and refactor</font></tt>
<br>
<br><tt><font size=2>With that in mind, Simon*, I've started up a new page:
http://www.pmwiki.org/wiki/PmWiki/WikiRefactoring A good chunk of
your mail below could be dropped in there. As well as other entries in
the "thread."</font></tt>
<br>
<br>
<br><tt><font size=2>Where should this page be? It's not a Cookbook recipe;
and the other other applicable group seems to be PmWiki -- but is that
to be "Reserved" for documentation?</font></tt>
<br>
<br>
<br><tt><font size=2>*your profile seems to be http://www.pmwiki.org/wiki/Profiles/Simon
correct? And I am OtherMichael, in the interests of full disclosure.</font></tt>
<br>
<br><tt><font size=2>----------</font></tt>
<br>
<br><tt><font size=2>Message: 2<br>
Date: Tue, 06 Mar 2007 20:18:57 +1300<br>
From: Simon <s-i-m-o-n@paradise.net.nz><br>
Subject: Re: [pmwiki-users] Does this list inhibit development of
good<br>
documentation?<br>
Cc: pmwiki-users@pmichaud.com<br>
Message-ID: <45ED15E1.3070006@paradise.net.nz><br>
Content-Type: text/plain; charset="iso-8859-1"<br>
<br>
I think the short answer is yes.<br>
<br>
It is tooo easy for a quick question to be flicked off,<br>
instead of ''reading the documentation''.<br>
<br>
Thinking about what you want and reading documentation is hard,<br>
getting someone else to think for you is easy.<br>
<br>
UseMod is a wiki with NO email list. - this is good.<br>
Consequently its website (eating its own dog food) is better polished<br>
and up to date.<br>
<br>
The longer answer is that it is incumbent on us to<br>
* refer to the seemingly most pertinent documentation we have searched<br>
in our quest for an answer<br>
* update the documentation with the answer after we receive it, or<br>
* if the answer was already there, add a few links and references from<br>
where we thought it would be to where it is.<br>
<br>
<br>
Documentation isn't a linear or a hierarchical thing.<br>
Its a network.<br>
What we need is content and navigation.<br>
<br>
Content is simply a matter of thinking about what needs to be said,<br>
and then writing it down.<br>
<br>
Navigation is subtler. Its a personal thing.<br>
<br>
PmWiki is admirably provided with navigation through the page and group<br>
structure,<br>
search, categories.<br>
<br>
So, its up to you<br>
- use PmWiki more,<br>
- use the mailing list less<br>
- write and refactor<br>
<br>
cheers<br>
<br>
Simon<br>
<br>
PS I use my profile page to list the documentation I find most valuable.</font></tt>
<br><font size=2 face="sans-serif"><br>
Michael J. Paulukonis<br>
Programmer/Analyst<br>
Diversified Information Technologies<br>
570.207.2413 or 570.343.2300 x 3043<br>
</font><font size=3 face="sans-serif"><br>
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++<br>
CONFIDENTIALITY NOTICE: If you have received this e-mail in error, please<br>
immediately notify the sender by e-mail at the address shown. This e-mail<br>
transmission may contain confidential information. This information is<br>
intended only for the use of the individual(s) or entity to whom it is<br>
intended even if addressed incorrectly. Please delete it from your files<br>
if you are not the intended recipient. <br>
Copyright (c) 2007 Diversified Information Technologies<br>
++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++</font>