don't include private API in readme; improve docs