note that the builder for the docs is a mean animal so refer to the github api module for examples that work.  Greping the angular source or `@...` is also a good way to learn what is available