Histoire d'un développeur SI
#10. Qu'est-ce que la documentation dans un projet SI ?

Dans un projet si, il faut soumettre des documents à la société cliente pour prouver que le projet a été bien réalisé.

De la proposition à la définition de l'écran, en passant par le document de conception, le manuel d'utilisation, etc., il existe des documents à rédiger en fonction des étapes du projet, de la proposition de projet à la conception, au développement, aux tests, à l'ouverture et à l'exploitation, mais c'est généralement les développeurs débutants qui s'en chargent.

Lorsque l'on rédige des documents, on se demande parfois si l'on est bien développeur ou si l'on est plutôt employé de bureau. De plus, en Corée du Sud, il est fréquent de se retrouver à devoir effectuer la documentation à chaque étape juste avant la fin du projet. En effet, cela est dû aux raisons suivantes :

• La durée du projet étant courte, il faut le réaliser le plus rapidement possible et la documentation doit être crédible afin de terminer le projet dans les temps.
• De toute façon, même si l'on crée des documents étape par étape, les exigences seront modifiées ou ajoutées. Il est donc plus rapide de les créer tous et de les mettre en forme en fonction des exigences.

C'est ironique, mais c'est une méthode qui a évolué ( ?) naturellement dans la culture si coréenne.

Il existe de nombreux outils pour dessiner des définitions d'écran, mais il est possible d'assister à un miracle : la définition d'écran est créée à partir d'une capture d'écran de l'écran opérationnel.

En général, les développeurs détestent la rédaction de documents, mais que voulez-vous, vous êtes débutant.

Ce sont les nouveaux employés qui sont chargés de la documentation. De toute façon, on ne peut pas leur confier le développement directement, on va donc leur faire faire de la documentation.

De toute façon, c'est pour que je puisse faire de même avec mon successeur plus tard, alors profitons de l'occasion pour en créer un bon.