[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 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