docs: Add doc comments

This is almost copy-paste from docs/api/README.md.
Preparation for auto generated API docs.