Discussion :

[KooR.fr]

Bonjour.

Le framework Ellipse est une solution de développement d'applications web à base de technologies Java et Javascript. Il existe d'autres solutions équivalentes sur le marché, mais un point nous a toujours chagriné*: force est de constater que les documentations des API cliente (Javascript) et serveur (Java) sont toujours distinctes.

Il nous est apparue être une bonne idée d'intégrer ces deux axes de documentation comme étant un tout unique. Pour exemple, vous pouvez jeter un coup d’œil à la documentation de l'API du framework Ellipse en activant le lien suivant : http://www.infini-software.com/Encyc...doc/index.html

Si vous être curieux, vous y reconnaîtrez une Javadoc quasi classique, mais dans laquelle nous y avons intégré des packages contenant des classes Javascript (corelib.services.web.javascript.jwt par exemple).

Pensez vous que cette manière de présenter les documentations des API apporte une réelle plus-value, ou au contraire que cela ne change rien.

Merci pour vos retours.
L'équipe Ellipse

[kdmbella]

a mon avsis tout dépend de l'application développée : s'il s'agit d'une application Web faisant usage du js là ça apporte un plus c'est certain; mais si c'est du java classique en client lourd alors dans ce cas ça devient je vais dire encombrant. D'autre part est ce qu'il n'y à pas confusinon entre les classes js et les classes Java classique? ou alors est ce qu'il n'y a pas en même temps des méthodes ou fonctions qui se retrouve autant en js qu'en Java?