Table des matières
Ce chapitre suppose qu'on utilise Docbook, mais il serait quasiment identique pour DITA.
Typiquement, un Docbook sera constitué de chapitres contenant des sections et sous sections. En effet, une section docbook ne peut pas contenir de chapitre. Il est possible de réunir des chapitres dans des Part, mais il ne semble pas que l'élément Part soit bien supporté par les applications. Enfin il est possible de réunir plusieurs docbook en un grand Set docbook.
Il faudrait des modèles type de document, avec des chapitres (Installation, Sauvegarde, Maintenance, Incidents ...) que l'on retrouve à l'identique pour chaque domaine (Serveur, Réseaux, Site ...) A définir ensemble !
On peut classer les documents dans une arboressence de répertoire du type :
Les logiciels, OS utilisés. Ex. : Apache, MS-SQL-Server, Qmail ...
Les clients avec les services associés (messagerie, Web ...) ainsi que les mots de passe d'accès à leurs Administration, FTP ...
le schéma des différents LAN de PROVAL. (Issu du serveur de doc de ET.)
Descrition des machines serveurs, services (SQL, HTTP ...), méthode de sauvegarde, installations particulières.
Etudes générales des différents services : sauvegarde, statistiques, documentation.
Description des développements particuliers des sites web. Maintenance.
Cette arboressence peut facilement évoluer.
La documentation peut se diviser en plusieurs "sources" :
des fichiers XML Docbook qui forment une unité cohérente sur un sujet donné.
des fichiers XML Docbook qui soient formé par inclusion de chapitres ou sections d'autres Docbook. Pour des sujets "transversaux" comme les statistiques, qui pourrait inclure les chapitres LOG des documents Apache et MS-IIS.
Voir Modular Docbook File pour l'utilisation de XInclude avec Docbook.
des fichiers XML avec une DTD spécifique pour définir la carte d'identité du client et ses services. (On pourrait aussi bien utiliser une base de donnée, seule la méthode d'édition change..)
des Bases de données d'incidents, historiques d'interventions exportées aux formats XML ou nativement XML. (A créer.)