Compacité de la compréhension

produire des programmes clairement écrits, bien structurés, faciles à comprendre et à maintenir.

Qu’est-ce qui fait qu’un code est facile à maintenir ? La fonction essentielle d’un code maintenable est « la compacité de la compréhension ». C’est-à-dire, la caractéristique du code qui permet de comprendre rapidement son but et sa logique. Optez donc pour des pratiques de programmation qui servent la compacité de la compréhension. En examinant les nombreuses options de coding du RPG moderne, évaluez-les pour déterminer si elles vont bien dans ce sens.

Le principe même de la compacité de la compréhension est que nous comprenons mieux le code si nous le divisons en petits blocs bien structurés et ciblés. En langages orientés objet, comme Java, ces blocs de code sont des méthodes dans une classe (objet). En RPG, ce sont généralement des procédures, sauf pour le bloc principal et peut-être une poignée de courtes sous-routines subalternes. Les procédures peuvent être soit des sous-procédures dans le programme d’utilisation, soit des procédures dans un programme de service.

Il ne faut pas confondre la compacité de la compréhension avec un code compact. En effet, ce que nous voulons rendre compact n’est pas tant le code que sa « compréhension ». Un code simplement compact peut être obscur et pas facilement compréhensible. La « forme » du code compact contribue aussi positivement (ou négativement) à la compréhension du code. C’est pourquoi, dans l’expression de la logique du programme, on préfèrera le code en format libre aux spécifications en format fixe, et dans le concept et l’implémentation de l’activité d’I/O, on préfèrera SQL à l’I/O natif.