Qu'est-ce que la compréhension de programme?
La compréhension d'un programme est la capacité d'un programmeur à comprendre le rôle du code source d'un programme informatique. Dans l'enseignement informatique, la compréhension d'un programme est souvent négligée au profit de l'apprentissage des mécanismes et de la syntaxe du langage informatique enseigné. L'écriture de code compréhensible, cependant, est un besoin universel, quel que soit le langage informatique dans lequel il est écrit. Si un programmeur écrit une bibliothèque ou un morceau de code, mais que personne ne peut déterminer ce qu'il fait par la suite, l'algorithme et la logique sous-jacents à ce code peuvent facilement être perdus. Il est de plus en plus courant que les programmeurs ne puissent pas déchiffrer leur propre code, car il n’est souvent pas écrit clairement et intuitivement.
Il existe deux stratégies principales que les programmeurs peuvent utiliser pour améliorer la compréhension du programme. Chacune a ses avantages et ses inconvénients. La première méthode consiste à ajouter de la documentation au code pendant ou après la création du code, et la seconde consiste à écrire du code en mettant l'accent sur sa structure. Une combinaison des deux approches est utile pour la plupart des programmeurs, bien que certains constructeurs de code préfèrent une stratégie à une autre. La méthode à utiliser est une question de préférence personnelle du programmeur, et toute tentative de clarification du code vaut bien mieux que rien du tout.
Ajouter de la documentation au code est la plus simple des deux méthodes et, une fois terminé, il peut s'avérer très utile pour un programmeur non familiarisé avec le langage dans lequel le code est écrit. La plupart des langages informatiques ont un style de documentation spécifique pour faciliter la compréhension du programme. Si la documentation de code est rédigée de manière exhaustive, la première étape d'un nouveau programmeur peut être de lire toute la documentation et les commentaires pour comprendre le fonctionnement du programme, sans avoir du tout lu le code. Au lieu de dépendre de la syntaxe et de la mécanique du code, le programmeur peut voir ce qui se passe en texte brut, puis associer le texte à ce qui se passe exactement à un endroit donné. Cependant, lors de l'ajout de documentation au code, les programmeurs doivent faire preuve de prudence, car trop de documentation peut être déroutante et intrusive, plutôt qu'utile.
Lorsqu’il écrit du code en mettant l’accent sur la structure, le programmeur suppose que tout autre responsable qui examine son code aura une connaissance équivalente de la syntaxe et des mécanismes de la langue. Parfois, cette hypothèse est valable, mais on ne peut pas toujours s'y fier. La compréhension du programme basée en grande partie sur la structure est possible, mais le programmeur d'origine demande beaucoup plus de travail pour le faciliter. La mécanique et la syntaxe du langage doivent être scrupuleusement respectées, de même que toutes les conventions stylistiques, et tout doit être cohérent. Lorsqu'il écrit du code de cette manière, un programmeur doit toujours être conscient du fait que ce qui est clair pour lui peut ne pas l'être pour une autre personne.
Même lorsque vous écrivez du code avec un oeil pour une compréhension ultérieure du programme, une documentation supplémentaire ou des modifications structurelles peuvent être nécessaires ultérieurement. Cela fait naturellement partie de la maintenance du code et ne constitue pas un échec de la part du programmeur. Le travail d'un programmeur consiste à anticiper autant de problèmes de compréhension que possible, mais tous ne sont pas toujours pris au piège.