[Histoire des développeurs SI] 10. Qu'est-ce que la documentation dans un projet SI ?

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 au client pour prouver que le projet a été correctement réalisé.

Des documents doivent être rédigés à chaque étape du projet, depuis le cahier des charges jusqu'au manuel utilisateur en passant par le spécification des écrans, le document de conception, etc. En général, ces tâches sont confiées aux développeurs débutants.

Lors de la rédaction de documents, on se demande parfois si on est vraiment développeur ou si on n'est pas plutôt un employé de bureau. En Corée du Sud, il est fréquent que la documentation de chaque étape soit effectuée à la toute fin du projet, juste avant sa clôture. Les raisons sont les suivantes :

• La durée du projet est courte, il faut donc le réaliser le plus rapidement possible et créer une documentation présentable afin de respecter les délais.
• De toute façon, les exigences évoluent et changent, même si la documentation est créée étape par étape. Il est donc plus rapide de tout créer et de l'adapter ensuite.

Ironiquement, même si l'ordre est incorrect, c'est une méthode qui a évolué naturellement dans la culture SI coréenne.

Il existe de nombreux outils pour créer des spécifications d'écran, mais on peut assister à des scènes miraculeuses où la spécification d'écran est créée en capturant des images de l'écran final.

En général, les développeurs détestent la rédaction de documents, mais que faire ? Vous êtes débutant.

Les nouveaux employés sont les plus faciles à exploiter pour la documentation. Puisqu'on ne peut pas leur confier immédiatement le développement, on leur confie la rédaction de documents.

De toute façon, si vous le faites, vous pourrez ensuite le faire faire à vos remplaçants. Profitez-en donc pour vous investir et créer des documents de qualité.