[pmwiki-users] Troubleshooting versus FAQ versus Error Messages versus ...?
Neil Herber
nospam at eton.ca
Sat Mar 11 20:47:32 CST 2006
At 2006-03-11 07:48 PM -0600, Patrick R. Michaud is rumored to have said:
>I'm having difficulty understanding the purpose behind having
>separate pages for
>
> Troubleshooting
> Error Messages
> FAQ
> Questions
>
>It seems to me that some of these could or should be combined
>-- any comments or suggestions?
At one point, Hagan and I and a few others were hacking away at the
FAQ page. It had become an unreadable mass of questions with very few answers.
To help organize things somewhat, we split it into 3 pages:
FAQ - which had questions *with* answers. To keep the page readable,
many answers refer to other pages.
Questions - place where people could post questions that might get
answered or be frequent, but that would not clutter the FAQ page
rendering it useless once again.
Error Messages - was a place to collect explanations for the various
PmWiki related error messages (many of which had to do with server
configuration problems)
I think it is essential to keep the FAQ and Questions separate, but
Error Messages could easily become part of a Troubleshooting page.
Many FAQs have nothing to do with problems (troubles) and more to do
with "how do I ...".
Neil
Neil Herber
Corporate info at http://www.eton.ca/
Eton Systems, 15 Pinepoint Drive, Nepean, ON, Canada K2H 6B1
Tel: (613) 829-4668
More information about the pmwiki-users
mailing list