documentation et refactoring effectués, phase verte