doc: api: misc cleanups

Change-Id: Icdc16dd250d4fcb29069b49dded98dac66383bf0
Signed-off-by: Alon Bar-Lev <alonbl@redhat.com>