provide a top level query example to go along with the
top level generate example we already have

also fill in docymentation and copyright for all public
api