[pmwiki-users] pmwiki documentation: Edit Templates

[Curtis, Clayton]

I hope this discussion continues (and leads to a more accessible
documentation set).  I really respect all the work that goes on!!!  But
I am definitely in the camp of "it would help a lot to have things from
the cookbook that pertain to the core in the core documentation".  I'm
not sure whether the "too much documentation" view derives from impact
on download / storage (which I kind of doubt) vs issues with how it's
organized and how easy it is to comprehend it.  I definitely get the
issues of overlap in types of content and the fuzziness of audience
definition, but to me that's just more ammunition for NOT separating
Cookbook content that is core-related from documentation about the core.
(Sorry for the long post, but this one hit a nerve as a newcomer trying
to understand an incredibly rich tool set.)  I'm certainly willing to
serve as apprentice / slave labor if that would be any help.

Clayton Curtis MD PhD 
VHA-IHS Interagency Liaison & Enterprise Architecture 
 VAMC (00) 
 150 South Huntington Avenue 
 Boston, MA 02130 
 voice: 857-364-4786  cel: 617-794-7151 
 fax: 781-687-3470    email: clayton.curtis at med.va.gov 


-----Original Message-----
From: pmwiki-users-bounces at pmichaud.com
[mailto:pmwiki-users-bounces at pmichaud.com] On Behalf Of Patrick R.
Michaud
Sent: Sunday, March 26, 2006 9:31 AM
To: The Editor
Cc: pmwiki-users at pmichaud.com
Subject: Re: [pmwiki-users] pmwiki documentation: Edit Templates

On Sun, Mar 26, 2006 at 09:04:47AM -0500, The Editor wrote:
> Just a note:  I think this is a great idea.  I would love to have two
> separate help systems.  One for authors (simple) and one for
> administrators (advanced).  Completely separate.  

Along the lines of what Neil just mentioned, note that "simple"
and "advanced" doesn't neatly divide into "authors" and
"administrators".
We have things that are "advanced authoring" and others that are
"basic administration".

> Perhaps even
> different groups.  [...]
> If we do go this route though, there must be clear instructions to a
> new user how to download the extra "admin" level help files so they
> don't get confused at the lack of documentation. 

I'd say that if we do go with placing administrative docs in
a separate group, that the group is still part of the distribution
(in wikilib.d).

> I take it that each time I download
> a new version of PmWiki, I'm also upgrading my wikilib.d directory,
> with the latest documentation. (True?).  

Yes, this is true.

Pm

_______________________________________________
pmwiki-users mailing list
pmwiki-users at pmichaud.com
http://host.pmichaud.com/mailman/listinfo/pmwiki-users