Aller au contenu

Documentation et base de connaissances

3 min de lecture

La documentation est un pilier de la gestion des services informatiques. Elle permet de capitaliser l’expérience, d’accélérer les résolutions futures et d’assurer la continuité du service, même en cas de changement d’équipe.

Les types de documents que le technicien doit produire et maintenir sont :

  • Comptes rendus d’intervention : détails de chaque intervention réalisée.
  • Modes opératoires : procédures pas-à-pas pour les opérations courantes ou les évolutions planifiées.
  • Notes techniques : informations sur des problèmes spécifiques et leurs solutions.
  • Articles de base de connaissances : solutions documentées pour les incidents connus.
  • FAQ : réponses aux questions fréquemment posées.

Un bon compte rendu doit être clair, concis et correctement orthographié. Il suit généralement cette structure :

SectionContenu
En-têteDate, heure, numéro de ticket, technicien intervenant
ContexteDescription de la demande initiale de l’utilisateur
DiagnosticAnalyse réalisée, tests effectués, causes identifiées
ActionsDétail chronologique des opérations réalisées
RésultatSolution appliquée, validation par l’utilisateur
RecommandationsActions préventives, points d’attention pour l’avenir

Un mode opératoire est un document pas-à-pas destiné aux utilisateurs ou aux collègues techniciens. Pour être efficace, il doit respecter ces règles :

  • Utiliser un langage adapté au public visé (utilisateurs non techniques vs. techniciens)
  • Numéroter les étapes clairement
  • Inclure des captures d’écran si possible
  • Indiquer les prérequis en début de document
  • Prévoir une section de dépannage pour les problèmes courants
  • Dater et versionner le document

La base de connaissances (Knowledge Base) est le référentiel central qui capitalise l’ensemble des solutions connues. Bien alimentée, elle accélère considérablement le temps de résolution.

ChampDescription
TitreTitre explicite décrivant le problème (ex. : « Impossible d’imprimer sur HP LaserJet 5 »)
SymptômesDescription des symptômes observés par l’utilisateur
CauseCause identifiée du problème
SolutionProcédure détaillée de résolution
EnvironnementSystème concerné, version, configuration
Mots-clésTags pour faciliter la recherche
Auteur / DateTraçabilité et responsabilité

La gestion des problèmes (au sens ITIL) vise à identifier les causes racines des incidents récurrents. Le processus est le suivant :

  1. Identifier les incidents récurrents ou sans solution connue
  2. Analyser les tendances (statistiques de tickets)
  3. Investiguer la cause racine (analyse des 5 pourquoi, diagramme d’Ishikawa)
  4. Documenter la solution trouvée
  5. Enregistrer dans la base de connaissances comme « erreur connue »
  6. Diffuser l’information aux équipes concernées
  7. Vérifier que la solution réduit effectivement les incidents