[pmwiki-users] PmWiki docs - audiences (Was: suggested organizing ..

chr at home.se chr at home.se
Tue Jul 26 14:34:31 CDT 2005


On Tue, 26 Jul 2005, Neil Herber wrote:

> At 2005-07-26  12:15 PM -0500, Patrick R. Michaud is rumored to have said:
> >  What we
> >really need are some organizing principles for the documentation.
> 
> One of the problems I have with the current documentation is figuring
> out whether a particular item is a basic feature, an advanced feature,
> an add-on, or whatever. To my mind, some of the recent mailing list
> postings about styling images and creating user-specified edit forms
> cross over the border from "author-friendly" to
> "only-a-geek-would-want-this".

I think we're starting to need two lists now... the latest posts on div:s 
and inlined images would *really* scare any newbie reading them...

> First of all, I would suggest that the audiences be kept in mind when 
> creating docs, and I think there are 4 audiences:
> 1) new authors - they need to know how to do simple markup and should not 
> be overwhelmed by options
> 2) experienced authors - they are still primarily concerned with writing, 
> but they want more control over the final layout
> 3) new admins - need to know the minimum amount of stuff to get PmWiki up 
> and running
> 4) experienced admins - want to provide extra features, custom markup, etc.

Sounds like a very good idea IMHO. What do you think of creating separate 
trails for these users?

> It is quite tempting to extend the number of audiences - for example, 
> advanced admins might create their own skins - but having just 4 audiences 
> prevents creation of "audiences of one".

I don't understand... ?

/Christian


-- 
Christian Ridderström, +46-8-768 39 44               http://www.md.kth.se/~chr






More information about the pmwiki-users mailing list