This looks OK to me.  In the future we should have actual comments that say `@directive` which will generate docs, and the ieshiv task could perhaps look for those.  For now though, this is good :-)