unbreak links to source code
remove comments; will stick with the ascii diagrams