RE : [sdx-developers] RE : Systeme de documentation

[Martin Sévigny]

Bonjour,

> Ca commence mal : l'url fournie 
> (http://www.oasis-open.org/docbook/xml/simple/1.0b2/sdocbook-c
ustom.dtd) 
> pour la sdocbook ne répond pas :-(

A mon avis, si ton système d'édition a besoin de ressource sen ligne, tu
n'as pas fini d'avoir des problèmes. Je crois que tous les documents XML
du système de documentation de SDX devraient avoir des identifiants
PUBLIC valables ; les identifiants SYSTEM, de toutes façons, ça ne
marche pas... (théoriquement).

> J'ai le manuel (il en existe même une version française sous le tire 
> "docbook, la référence". Cher... :-). Je suis néanmoins 
> *très* surpris 
> par le manque d'exemples *réels* sur le WWW. C'est en ce sens que 
> j'aurais voulu comparer pplusieurs expériences pour voir les 
> tendances 
> générales...

Le livre de référence de DocBook chez O'Reilly est entièrement sur le
Web, et à jour : http://www.docbook.org.

> J'avais commencé (avec la "website") par
> webpage
>    head
>    section
> 
> à l'instar de ce que j'avais vu dans la doc website... Je recommence 
> comment ?

En fait, j'avais en tête que l'on écrivait des documents, qui par
"hasard" seront publiés notamment sur le Web, d'où l'idée d'utiliser
article. Mais si on fait d'abord d'un site Web, l'approche devrait être
différente.

Vous le voyez comment?

> Le mieux, c'est encore d'avoir un document test sur lequel 
> s'appuyer... 

Même s'il faut restructurer quelque peu les documents au départ, ce
n'est pas catastrophique (et je suis volontaire). J'essaie de faire une
première version de la roadmap cette semaine, ce sera un "document"
composé de quelques articles, on compare à ce moment?

A bientôt,

Martin Sévigny