Shorter comments and links in comments

Also split out the parse rules to make it more readable