Programmer avec Java

CHAPITRE 7 Conventions de rédaction et documentation

Ce chapitre regroupe quelques conventions importantes et pratiques concernant la rédaction du code source Java et de sa documentation :

• convention de nommage des identifiants et de capitalisation ;

• conseils et convention de portabilité ;

• syntaxe et convention des commentaires de documentation pour javadoc.

Conventions de nommage et de capitalisation

Les conventions qui suivent sont largement adoptées et s’appliquent aux modules, aux paquetages, aux types référence, aux méthodes, aux champs et aux constantes Java. Il est fortement conseillé de les adopter à votre tour parce qu’elles sont quasiment devenues des standards et ont un impact sur la compréhension et l’utilisation des interfaces ...