api-doc: cleanup descriptions

This unifies capitalization: The first letter of the first word upper
case, the rest lover case.

Signed-off-by: Tomasz Grabiec <tgrabiec@cloudius-systems.com>
Signed-off-by: Pekka Enberg <penberg@cloudius-systems.com>