doc: add readme, comments in code and rewrite name methods

Bogdan Slusarenko requested to merge issue_61/finish_writing_readme into master

Merge request reports