Improve documentation (to be suitable good)

[pahuttun]

Lets decide what needs to be documented and what doesn't.

• Write at least placeholders for required documentation
• Fix README.md from root: it should point to documentation files under documentation and have only most important information there