expose path generation
clean up the example