document the public web api in the readme