Mailing List Archive: 49091 messages
  • Home
  • Script library
  • AltME Archive
  • Mailing list
  • Articles Index
  • Site search

[REBOL] Re: Documentation: Let's do it NOW!

From: andrew:martin:colenso:school at: 11-Aug-2003 10:04

Robert wrote:
> 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 Fax: 64-6-8336759 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 any 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 Phone: +64 6 843 5095 or Fax: +64 6 833 6759 or E-mail: [postmaster--colenso--school--nz]