Update README docs for Dokka in stdlib

[IgnatBeresnev]

There's barely any documentation in kotlin-stdlib-docs, which leads to uncertainties and hidden gotchas when it comes to updating Dokka.

Some documentation about this module should be added. There are no specific topics in mind - cover whatever feels important within the given time frame.

Ilya has agreed to answer questions