I wish we did this in more locations in the code base.  Defining argument param types.  My main reason for wanting us to use JSDoc style documentation.  But that discussion is for another day....