We are *wildly* inconsistent about this all over. This method was actually just moved here, nothing was changed and a lot of the older methods in our driver have documentation done this way by our predecessors.

In the end, it actually doesn't matter, yard will parse it in either format. But, I do prefer the format your suggestion anyway. If you touch it, make it better! I correct the docs here.