refactored inline documentation

adapted phpdoc standards