bergie / VIE

Semantic Interaction Framework for JavaScript
http://viejs.org/
MIT License
303 stars 56 forks source link

Documentation improvments needed #70

Open ruKurz opened 12 years ago

ruKurz commented 12 years ago

The entities are the central data type in VIE. To cover the VIE functionality with a GWT wrapper implementation it is essential, to have a good understanding of the VIE internals. To represent VIE in Java world we have to define type safe interfaces. Currently it is a hard task to figure out the possible types of function arguments and return values. Even it is not typical in JS it would be great to have some documentation standard used to discribe function signatures.

bergie commented 12 years ago

Most of the Entity and Collection API follows the Backbone Model and Collection API. There are some additional methods, and for example entity get/set/has allow you to use either CURIEs or fully-expanded predicate URIs.

neogermi commented 12 years ago

Hi ruKurz,

we are currently working on proper documentation of VIE. You have access to the documentation here:

http://viejs.org/docs/2.0.0alpha1/VIE.html

Here is the current status of the documentation:

well documented:

not or only sparsely documented:

The agreement was that I took resposibility for the first part and Henri and Szaby are working on the remaining files.