pants doc gen: fix up relative paths that assumed "twitter/pants" (vs "pants")

also added a shebang line for easier invokes