Update docs

@lob/api-engineering-lobsters ready for review. I kept the API.md separate but can merge it if that seems better to you guys. IMO, easier to read this way.
Can you adjust this example to reflect requiring the package in a file rather than being run at the REPL