Docs

[egordorichev]

@Col-E wants us to have docs. I think, that's a good idea. We have three ways of doing it:

• Just docs in code
• Javadoc on github pages (we need to sync it with auto builds on CI)
• Extra markdown docs

I like the second way. The only thing is, that this will make our code pasta-looking. As the "Clean Code" book tells, javadoc is not always good.

Any thoughts?

[egordorichev]

Doing them with java doc, they are hosted here.