It's awesome that these are documented!  yuidoc's param tag actually understands nested object arguments, so I don't think this needs to be ad hoc style.  See http://yui.github.io/yuidoc/syntax/index.html#param