[Pmwiki-users] suggestions for the new documentation structure

[Robert P. J. Day]

On Mon, 18 Oct 2004, Patrick R. Michaud wrote:

> On Mon, Oct 18, 2004 at 08:40:08AM -0400, Robert P. J. Day wrote:
> > On Mon, 18 Oct 2004, Patrick R. Michaud wrote:
> >
> > > The outline you presented above is excellent for administrators, because
> > > it places things in the order an administrator might encounter them when
> > > setting up the software.  But it's not so good for authors--people who
> > > are writing wiki pages but not running the software--because they have
> > > to get past (or overlook) the installation and configuration details
> > > before they get to the sections on creating, editing, and other markups.
> >
> > i thought about that, but these days, what with more and more people
> > running their own boxes, a lot of these authors *are* the
> > administrators.  didn't used to be that way, but it's certainly
> > becoming more common.
>
> It may be more common, but I'm more concerned about the case where
> an administrator wants to have lots of authors on his/her site (who
> certainly won't be administrators).  Even though administrators are
> becoming more common, it will always be the case that there are orders
> of magnitude more authors than administrators.
>
> I don't want PmWiki to only provide documentation to the administrator--
> I think that PmWiki should also provide the administrator with
> documentation for his/her authors.

i'm not sure we're disagreeing all that much here.  let me think about
it and i'll get back to you.

rday