Remove inline api documentation. Leave only implementation details
Fix wording
Merge pull request #25 from SUSE/review_140313_drop_documentation_of_api

Remove inline api documentation. Leave only implementation details