maj documentation according to refactoring