Re: [pmwiki-users] Does this list inhibit development of good documentation?

2007-03-08 Thread Mark Trumpold
HI I haven¹t been following this thread to closely but one thing that occurred to me after refecting a little on this discussion was ... I started back in Sept 06, I love Pmwiki and its relative freedom and so on. At the beginning I couldn¹t make heads or tails of the cook book and what it all

Re: [pmwiki-users] Does this list inhibit development of good documentation?

2007-03-07 Thread Sandy
Oliver Betz wrote: Tegan Dowling wrote: [What is *wrong* with DocumentationIndex] I'll bet it's the more ... reference than ... tutorial aspect -- that a new-comer to it encounters the all-too-common, and hugely frustrating situation, in which one new word or phrase is defined in terms

Re: [pmwiki-users] Does this list inhibit development of good documentation?

2007-03-07 Thread Oliver Betz
Sandy wrote: [...] IMO PmWiki has a rather good documentation compared to other wikis I know. One problem is that there are so many features to describe. The other problem is that there are so many different ways to accomplish the same thing. Some are more secure, others require less

Re: [pmwiki-users] Does this list inhibit development of good documentation?

2007-03-07 Thread Dr Fred C
In this respect, there _are_ issues in the documentation. For example AuthUser - UserAuth, many people asked for clarification in pmwiki.org. Along the same issue is there are several interpretations and uses for "templates" in PMWiki. "XL templates" are for converting pmcommands

Re: [pmwiki-users] Does this list inhibit development of good documentation?

2007-03-06 Thread Jan Erik Moström
Reply to Tegan Dowling [EMAIL PROTECTED] 07-03-05 23:25: I'll bet it's the more ... reference than ... tutorial aspect -- that a new-comer to it encounters the all-too-common, and hugely frustrating situation, in which one new word or phrase is defined in terms of another one, and a new user has

Re: [pmwiki-users] Does this list inhibit development of good documentation?

2007-03-06 Thread Francis Casson
On 06/03/07, Kathryn Andersen [EMAIL PROTECTED] wrote: What is *wrong* with it? Are the Beginner topics too advanced? Conversely, is there a lack of advanced topics? Or is it that it is more of a reference than a tutorial? For me, I was able to learn most basic stuff that I needed from the

Re: [pmwiki-users] Does this list inhibit development of good documentation?

2007-03-06 Thread Hans
Tuesday, March 6, 2007, 9:58:09 AM, Francis wrote: For me, I was able to learn most basic stuff that I needed from the Documentation Index, with a little effort. More advanced topics such as eexplanations of the PmWiki code would be useful though. You find Pm often added explanations to

Re: [pmwiki-users] Does this list inhibit development of good documentation?

2007-03-06 Thread Oliver Betz
Simon wrote: [...] UseMod is a wiki with NO email list. - this is good. Not in my opinion. I don't want to _discuss_ on a web site (including forums). Only mailing lists and newsgroups are efficient enough. Results of a discussion shall go to a more static location. Oliver -- Oliver Betz,

Re: [pmwiki-users] Does this list inhibit development of good documentation?

2007-03-05 Thread marc
Kathryn Andersen said... On Sun, Mar 04, 2007 at 05:27:00PM +, Francis Casson wrote: Many people (including myself) come to this list after failing to find the answer we need in the documentation on PmWiki.org - or not understanding it. I propose encouraging the following mailing

Re: [pmwiki-users] Does this list inhibit development of good documentation?

2007-03-05 Thread Keith Edmunds
On Mon, 5 Mar 2007 10:07:03 +1100 Kathryn Andersen [EMAIL PROTECTED] wrote: Lovely idea -- but part of the difficulty is in trying to figure out what the relevant place *is*. Good point. I've just come to pmWiki, and - despite more years than you want to know of IT experience, programming,

Re: [pmwiki-users] Does this list inhibit development of good documentation?

2007-03-05 Thread Hans
Monday, March 5, 2007, 11:18:17 PM, Keith wrote: The most frustrating thing with pmWiki is that it is very powerful, but there is no ONE place to go to find the detail. Instead there are many pages of information, each of which cross-reference others (in wiki style). At the start, we just

Re: [pmwiki-users] Does this list inhibit development of good documentation?

2007-03-05 Thread Kathryn Andersen
On Tue, Mar 06, 2007 at 01:47:47AM +0100, Jan Erik Mostr??m wrote: Reply to Tegan Dowling [EMAIL PROTECTED] 07-03-05 18:02: Did the DocumentationIndex actually fail you in that regard (if so, how?), or did it not appear to be a candidate for that kind of reading (if not, why not?) The

[pmwiki-users] Does this list inhibit development of good documentation?

2007-03-04 Thread Francis Casson
Hi all, Many people (including myself) come to this list after failing to find the answer we need in the documentation on PmWiki.org - or not understanding it. I propose encouraging the following mailing lists ethic: If you seek the answer to a question and find it on the mailing list, then

Re: [pmwiki-users] Does this list inhibit development of good documentation?

2007-03-04 Thread Kathryn Andersen
On Sun, Mar 04, 2007 at 05:27:00PM +, Francis Casson wrote: Many people (including myself) come to this list after failing to find the answer we need in the documentation on PmWiki.org - or not understanding it. I propose encouraging the following mailing lists ethic: If you seek the