implemented service method descriptions
refactoring