These yard docs are pretty thin.  It's good to document the arguments, include an example, etc.