[Gridflow-dev] common patterns and protocols

[Mathieu Bouchard]

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)
	http://rubygarden.org/ruby

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