Re: [sdx-developers] Documentation

[Pierrick Brihaye]

Suite sur la doc :

index.xml :

"qui est une adaptation de Docbook pour créer des ensembles de pages". 
Euh... HTML ? "un site WWW" ?

Le lien vers test ne fonctionne pas. Il revoie sur... index.html.

telecharger.xml : ajouter un lien vers le SDK ? des clients CVS ? JavaCC ?

architecture.xml :

"la diffusion et la recherche d'une même collection de documents". Quel 
est le sens de "même" ? Même schéma ?

"Un système d'informations pour le stockage". "Un système de stockage" 
tout court ?

Préciser les autres SGDB qui ont pu fonctionner avec SDX-1 ?

Le lien Cocoon-1 renvoie vers Cocoon... 2

"On restait dans le modèle d'une fenêtre web développé sur une source 
d'informations". Pas clair...

"pages logiques" pas clair...

Je n'arrive pas à accéder au lien IBM.

"la "servlet". Moi je dit "le". Qu'en pense la commission de 
terminologie ? :-)

"sans plus aucun lourd système d'information à installer". Confus.

La liste non ordonné arrive comme un cheveu sur la soupe à mon avis. Il 
faudrait peut-être un phrase d'introduction ?

serveur.xml :

"même si en général ce ne sera pas le cas.". On pourrait expliquer 
pourquoi : 1) ce n'est pas nécessaire 2) conflits potentiels

soient les applications, les bases de documents, les entrepôts de 
documents. Introduire des liens ?

"à ces applications, bases et entrepôts qu'il héberge". Liens ?

Je reviens sur "possède une adresse IP". Pour un lecteur lambda, ça 
prête à confusion. Combien de gens savent qu'un DNS a pour vocation à 
faire correspondre un hôte à une IP ? Certains auront à installer des 
applis sur des machines qu'ils ne contrôlent pas...

"l'élément hiérarchique supérieur sdx:framework". a passer en <sgmltag> ?

application.xml :

"Plus précisément, une application SDX reste dans le contexte de pages 
serveur XML (XSLT, Cocoon-2), c'en est d'ailleurs une illustration 
avancée". Pas clair...

"à l'exception d'une seule trace". Pas clair, même si je sais ce qu'il y 
a derrière cette phrase :-)

bases.xml :

"liste de champs de recherche" et "définition des ensembles de 
recherche". A mettre en liste ?

entrepots.xml :

"en garder l'adresse". "une référence" ?

"documents copiés ou référencés", "responsabilité informatique" et 
"sauvegardes". Passer en liste ?

Quelques typos corrigées dans leCVS.

La suite bientôt...

--
Pierrick Brihaye, informaticien
Service régional de l'Inventaire
DRAC Bretagne
mailto:address@hidden