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

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

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 mai

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 Mon, Mar 05, 2007 at 11:18:17PM +, Keith Edmunds wrote: > 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*. > The problem, I think, is that wikis use

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

2007-03-05 Thread Jan Erik Moström
Reply to Hans <[EMAIL PROTECTED]> 07-03-05 23:30: >How did you get on with the PmWiki/DocumentationIndex? >Is this page helpful for a start? As a guide perhaps even to read some >pages linearly? The documentation pages have also got wiki trail links, >with which you can go from page to page, in th

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

2007-03-05 Thread Tegan Dowling
On 3/5/07, Jan Erik Moström <[EMAIL PROTECTED]> wrote: > Reply to Hans <[EMAIL PROTECTED]> 07-03-05 23:30: > > >How did you get on with the PmWiki/DocumentationIndex? > >Is this page helpful for a start? As a guide perhaps even to read some > >pages linearly? The documentation pages have also got w

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

2007-03-05 Thread Jan Erik Moström
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 DocumentationIndex is an excellent source of information which I'm start

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?) >

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

2007-03-05 Thread Tegan Dowling
On 3/5/07, Kathryn Andersen <[EMAIL PROTECTED]> wrote: > 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

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

2007-03-05 Thread Oliver Betz
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 of another one, and

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

2007-03-05 Thread Simon
I think the short answer is yes. It is tooo easy for a quick question to be flicked off, instead of ''reading the documentation''. Thinking about what you want and reading documentation is hard, getting someone else to think for you is easy. UseMod is a wiki with NO email list. - this is good. C

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 us

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 t

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 f

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

2007-03-06 Thread Dr Fred C
IMHO, the real problem isn't so much the documentation, which does vary in ease of use and understandability.  For the most part, cookbook use is dead simple.  Install a cookbook file to the cookbook folder and enter some simple line of code in the local config file.  Then start using the featu

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

2007-03-06 Thread The Editor
On 3/6/07, Dr Fred C <[EMAIL PROTECTED]> wrote: > > IMHO, this is where the problem really lies. A fair amount (but not all) > of cookbook documentation provides little to no workable examples of the > cookbook features in actual use. Instead, everyone basically has to > reinvent the wheel over

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

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 requir

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