Clarification noms d'attributs

Et ajout de JavaDoc sur certaines méthodes