Usage de votre code
Votre code est destiné à être utilisé
VOUS DEVEZ Documenter votre code
2 documentations :
à destination des usagers de la classe : ils ne doivent pas
connaître l’implémentation.
Ils doivent uniquement connaître :
La façon d’installer et d’exécuter
Les fichiers .class et leur emplacement
Et la documentation de l’interface de la classe : javadoc
à destination des développeurs qui doivent faire évoluer votre
code: ils doivent connaître l’implémentation.
Livraison des .java
Et Documentation de l’implémentation de la classe : UML, cahier
des charges, spécifications détaillées, commentaires dans le code