adding better usage examples in overview section, pointing to REST docs for the others.