Fix up capitalization and usage in API OS section

Make capitalization consistent, fix inconsistent notes
and usage.

Signed-off-by: Don Marti <dmarti@cloudius-systems.com>