PR review fixes.
Added file with notes about API.