[pmwiki-users] RFC: PITS 00701 -- WikiFarm confusion
Patrick R. Michaud
pmichaud at pobox.com
Wed Mar 15 20:07:31 CST 2006
On Wed, Mar 15, 2006 at 02:41:26PM -0700, Bellave Jayaram wrote:
> Most of the developer and administration documentation should be separated
> from end user documentation. This is one of the frustrating things about the
> present PmWiki site. The end user documentation should only contain the
> basic concepts, simple tasks and references relating to authentication,
> editing, groups, markups, searching, trails and publishing. I am willing to
> bet that only about 10% (if that) of PmWiki users even care about Recipes
> and how to configure things. Only if the question is still not answered with
> that documentation would anyone need to refer to the numerous pages on
> pmwiki.org that are only relevant to developers and admins.
Could I get you to clarify what group the word "users" is supposed
to indicate in the above sentence?
P.S.: For those who haven't been exposed to my previous rants on the
topic: I almost always find the word "user" confusing and frustrating
because it's too generic a term. In PmWiki's case the word "user"
could refer to an author, a wiki admin, a visitor, a system administrator,
or a field admin, and possibly more.
As an extreme example, as a professor I was once asked to
review a Master's thesis where the student had written a paragraph
that had four instances of the word "user" in it, and each instance
"user" actually referring to a different person (a student, a teacher,
a system administrator, and a programmer).
More information about the pmwiki-users