document how to run it and add examples