document the example some more with some tweaks. push the correspinding updated generated docs too