[Gridflow-dev] Documentation

[Mathieu Bouchard]

On Thu, 18 Jan 2007, Alexandre Castonguay wrote:

> I think scrapping the html reference files is a bad idea.

If no-one is willing to update it, then it's obsolete, that's all. Looking 
at the facts, such as cvs log, no-one is willing to update it.

> Having a searchable page with all objects online is a good thing.

Why? (why not grep keyword *-help.pd ?)

> It could be simple : a list and a short description of each object.

If a short description is a one-liner, then that is the same thing that I 
want to have in the class browser, and it's the first part of the 
documentation that I get people to translate into several languages. 
DesireData has no mechanism for picking up one-liner descriptions, but it 
will, for sure.

> It doesn't need to be as involved as the old one.

So, how involved should it be, exactly?

  _ _ __ ___ _____ ________ _____________ _____________________ ...
| Mathieu Bouchard - tél:+1.514.383.3801 - http://artengine.ca/matju
| Freelance Digital Arts Engineer, Montréal QC Canada