[REBOL] Re: Documentation: Let's do it NOW!
From: andrew:martin:colenso:school at: 11-Aug-2003 10:04
> Ladislav wrote:
> > The documentation wiki idea looks like yet another forking in
> > this area. Did Robert have a look at the R.E.P. site?
> Hi, I had several looks at the WiKi but to be honest, I seem to be too
> dumb to use it. I never understood how to navigate it efficiently and
> find what I'm looking for...
> Maybe others have the same problem. The idea of a WiKi is good but for
> me it needs to be streamlined. I don't want to browse around without a
> clear structure, I can't track it all the time to understand the
> structure change and evolvement over time etc.
> It's a bit too chaotic for me to use it... Robert
I agree with Robert. Most Wikis, including the Vanilla REP site, are too
hard to find information in. They tend to obscure information and don't
allow the equivalent of viewing a directory listing in a file explorer.
For example, most wikis won't allow viewing the contents of a directory
or folder. Most wikis also show far too many controls to play with on
each page, and so confuse the user with lots of options which don't mean
much and aren't important, while important options are drowned out in
the visual confusion. Most wikis disallow single word links and don't
allow words with spaces, so requiring special ways around this problem
which usually aren't documented! :)
Andrew J Martin
Attendance Officer &
Information Systems Trouble Shooter
Colenso High School
Arnold Street, Napier.
Tel: 64-6-8310180 ext 826
DISCLAIMER: Colenso High School and its Board of Trustees is not responsible (or legally
liable) for materials distributed to or acquired from user e-mail accounts. You can report
misuse of an e-mail account to our ICT Manager and the complaint will be investigated.
(Misuse can come in many forms, but can be viewed as any material sent/received that
indicate or suggest pornography, unethical or illegal solicitation, racism, sexism, inappropriate
language and/or other issues described in our Acceptable Use Policy.)
All outgoing messages are certified virus-free by McAfee GroupShield Exchange 5.10.285.0
Phone: +64 6 843 5095 or Fax: +64 6 833 6759 or E-mail: [postmaster--colenso--school--nz]