[Gridflow-dev] common patterns and protocols
matju at sympatico.ca
Tue Jan 25 10:02:34 EST 2005
On Sat, 22 Jan 2005, Stéphanie Brodeur wrote:
> Mathieu Bouchard <matju at sympatico.ca> wrote:
> I think it is a good idea to add a glossary of terms to the gridflow
> documentation. What you have suggested is informative and should be
> added. I also think there should be basic terms, which could seem
> obvious, but that are essential for beginners to understand. I was
> thinking of terms like grid, int, float, array... and explainning them
> in simple terms (some of the terms are explained in the manual but I
> think all the definitions should be together in the same glossary,
> even if it means repeating their definitions.)
Yeah, int and float and such are already explained in architecture.html; i
was thinking that this file could _become_ the glossary and be internally
hyperlinked and that the other doc files could hyperlink a LOT towards the
glossary too. What do you think?
But then it begins to smell a lot like a wiki. I mean a real wiki: if you
only have seen Tiki, that's a bunch of tools in which there is a wiki
among other things.
Examples of sites that are (almost) pure wikis may be:
http://c2.com/cgi/wiki (the oldest wiki! the original)
http://wikipedia.org/ (the most famous wiki, encyclopedia-style)
http://everything2.com/ (the biggest wiki i know, berserk-style)
http://planetmath.org/ (a smaller wiki)
If you already know what a wiki is, I'm sorry, it's just that it's still
amazing how many people don't, although it certainly is 100 or 1000 times
more popular than, say, 5 years ago. (I worked at a software company back
then and found out I was the only one knowing what a wiki is)
The two defining characteristics, IMHO, are:
1. internal hyperlinks that appear automatically or are very easy
to create (more so than in HTML).
2. easily editable from the web.
Personally I wouldn't aim too high, and I would have (1) but not (2), the
CVS being enough for our needs. Does that sound reasonable?
Mathieu Bouchard -=- Montréal QC Canada -=- http://artengine.ca/matju
More information about the Gridflow-dev