add docs for PathGenerator.