2) I would be very grateful to a link to some decent tutorial/documentation -- even if I have to pay for it...
It would be great to see something along the lines of the "FAQTutorial" but with more indepth look at available Velocity objects/macros and discussion of how Documents/Classes/Objects/Properties are actually related....
I can't believe this stuff isn't better documented :(

Yep we need to rewrite that tutorial on Class/Object/Templates/Classsheets. Would be great if you can help.

Here's a short version:

* Classes contain definition of a concept. A definition is made of properties. A property can be a string, a text area, a combo box, a radio button choice, etc. A class is created inside a document. There's a class tab in the edit view of a document.

* An Object is the instantiation of a Class in a document. This means that several documents can all instantiate the same class but have different values of the class properties. When you edit a document there's an Object tab that allows you to view all existing objects associated with a document and modify their properties values or add new objects.

* A classsheet is some generic code to display the content of an object. Classsheets are meant to be used by being included in a document containing an instance of the object they're meant to display. The include is done using #includeInContext("classsheet name").

* A classtemplate is simply an "empty" page that already has the include to the classsheet and an object added. It's meant to be used in forms and be copied when user ask to create a new document easily.

The 2 important core concepts are classes and objects. The rest (i.e. classsheet and classtemplates) are just easy ways to display object content and create new documents.

Hope it helps,

-Vincent