I'd prefer it is made clear in doxy why it works the way it does, rather than linking to github, as github PRs have a habit of eventually going missing.

I'm happy to do up a patch for you with the doxy, along with some cosmetic changes to the existing comments if you like.