more docs, solid example and requests.json