add public API docs to the README