I think this is a very reasonable way to document this. However, the google closure annotation is a bit different:
  https://developers.google.com/closure/compiler/docs/js-for-compiler

I don't really have a point here. We're never going to use closure. But very soon we need to write up our doc guidelines.