update rest and domain model, apiary documentation and comment my ressources