here comes the crazy documentation ubershit

This commit basically implements my idea of having
documentation of the ADK internals at the place
in the directory tree where the documented magic
takes place.