Présentation

La documentation constitue trop souvent le point faible du Système d'Informations. Contenu incomplet, obsolescence, manque de disponibilité ou diffusion confidentielle sont autant de maux qui font de la documentation le parent pauvre des délivrables. Pourtant elle reste un pré-requis incontournable avant toute évolution ou partage d'informations au sein du SI.

Objectifs

La puissance de nos Suites alliée à l'expertise de nos consultants nous permet de prendre en charge complètement votre projet de documentation. Ceci garantit la meilleure utilisation de l'outillage en libérant vos ressources internes pour des projets sur lesquels leur expertise métier est indispensable. La documentation produite s'appuiera sur les éléments techniques révélés par nos outils auxquels il sera possible d'ajouter un contenu fonctionnel. Elle saura ainsi répondre aux attentes de chacun des acteurs :

• Chaînes d'exploitation pour le service d'exploitation,
• Références croisées, documentation des développements pour le service des études,
• Modélisation de la base de données pour les administrateurs BD,
• Schémas de fonctionnement pour les responsables fonctionnels.

L'ensemble sera généré au format html en respectant votre charte graphique et donc accessible par tous sur un intranet.

Mise en oeuvre

Le projet peut se décomposer en plusieurs étapes adaptées à votre configuration et à l'objectif à atteindre :

• Un audit initial peut être proposé pour permettre d'assainir le nombre des composants à documenter. L'identification des occurrences multiples de sources ou d'objets ainsi que des sources sans objet ou objets sans source (copies de sauvegarde, vieux composants inutilisés, …) offre la possibilité d'isoler des éléments inutilisés et donc n'apportant pas de plus-value à la documentation.
• Le chargement de la base de données ARCAD (le référentiel) pourra être enrichi de données fonctionnelles qui seront restituées dans la documentation. Les composants pourront être classés selon une arborescence à trois niveaux. Celle-ci offrira alors un point d'entrée pour des chapitres de document.
• La définition des modèles de documentation devra tenir compte des différents niveaux de lecture que l'on veut offrir (de l'architecture générale avec ses diagrammes de flux, jusqu'à la compréhension du code source d'un programme) et intégrera la charte graphique en vigueur.
• La génération de la documentation pourra être répartie sur plusieurs serveurs afin d'assurer une production rapide.