[pmwiki-devel] ZAP cookbook, www.zapsite.org

Christophe David christophe.david at christophedavid.org
Thu Dec 7 02:47:09 CST 2006


I am still trying to encourage friends to have a look at the ZAP features on
www.zapsite.org.

Unfortunately, despite the obviously considerable time spent on improving
the documentation and giving support, there are still a few things that can
discourage even the most motivated visitors :

Examples:

- when visiting www.zapsite.org, you cannot even read the documentation
without being logged on.  The new visitor has no clue as why "nothing works"
without spending a lot of time searching.  Why not have full free access to
everything except the parts that actually use the ZAP features that require
to be logged on ?  Why not "pre-fill" the username/password fields with
"Guest" and "test" ?

- even more disturbing : when visiting ww.zapsite.org with Windows /
Internet Explorer using default security settings, many users can simply not
log in at all: the cookies are blocked because they are set for
www.fast.stand not
www.zapsite.org.  Users must click on an icon in the status bar to see the
security warning, and then find out that they could be more lucky with
http://www.fast.st/zap/pmwiki.php ...

- then when they finally managed to sign in and have found out that ZAP
provides interesting markup to make forms, they cannot find out what the
syntax is.

- the "documentation" section should probably be renamed into "reference",
and should be more comprehensive, with  exhaustive lists of all parameters
and their meaning, and pointers to the relevant snippets.

With the deepest respect for the work done and the obvious good will, may I
suggest to focus a lot more on the information provided to the users ?

Maybe allowing some wiki features on the site would allow users to
contribute ;-)

I am convinced ZAP is a tool  anyone developing with PmWiki should consider
using.  But the ZAP "packaging" really needs to be a lot more attractive.

Do other persons feel the same ?

Christophe
-------------- next part --------------
An HTML attachment was scrubbed...
URL: /pipermail/pmwiki-devel/attachments/20061207/7288077f/attachment-0001.html 


More information about the pmwiki-devel mailing list