Not a big deal, but it would be nicer if the header comments on these methods used [yardoc syntax](http://rubydoc.info/gems/yard/file/docs/Tags.md#List_of_Available_Tags).  `@param` and `@return`, etc.