agreed.  I like `@param`s followed by `@global` then `@return`