Add a couple comments to the Sphinx extension

I was referring to this file to try to imagine a better API for Sphinx extensions, and this was the only thing whose purpose wasn't immediately apparent.

Also fixed a comment typo.