[sdx-users] Manque de Documentation

[maisonneuve nico]

bonjour,

SDX a l'air d'avoir pas mal de fonctions, mais, comme pas mal de projets 
open-source, manque de documentations, de user guide, de FAQ ..

la documentation SDX que l'on peut trouver est claire, et bien faite mais 
incomplete , notamment sur les fonctionnalités avancées (comment faire des 
requetes complexes, utilisation des thesaurus,...),
il est vrai que l'on peut trouver des exemples d'applications dans le 
package mais rien ne vaut un tutorial..

############# UNE FAQ ###########"

je suis sûr que pas mal de personnes aimeraient que le temps que vous 
passiez a repondre a la mailing-list , le passiez à faire une doc plus 
fournie car des questions récurrentes sont posées dans la mailing-list. il 
serait plus judicieux de repondre une bonne fois pour toute et faire une FAQ 
ou en enrichissant la doc dejà existante

De même, l'utilisateur gagne du temps en ne scrutant la mailing-list
mais une FAQ ou une doc

######  UN VRAI EXEMPLE EXPLIQUE #############

il sera vraiment génial de faire un user guide avec un EXEMPLE un peu 
complexe(muktiple vue d'un document,rechreche:requete, CRUD create, 
retrieve, delete, update) de document XML) pour :
- bien montrer les fonctionnalités de SDX
- bien montrer comment utiliser ces fonctionnalités

########### listing des fonctionnalités  et différence entre les versions 
###########
un truc tout bête : publier une liste des fonctionnalités de SDX (feature) 
pour chaque version de SDX.En effet ON NE SAIT PAS ce que propose de pluse 
SDX 2.1 par rapport à 2.0
de même pour un SDX 2.0 par rapport 1.0


voilà...
le succes d'un projet open-source repose, je trouve , pas mal sur sa 
documentation.


utilisez votre temps, non pas à me répondre mais à enrichir votre doc ;-))

nico

_________________________________________________________________
Téléchargez gratuitement MSN Messenger ! http://www.msn.fr/msger/default.asp