fix(uiView): correctly detect $animator service
fix(uiSref): various click-related issues

- Always invoke digest loop
- Use $timeout to defer transition until other click events have processed
release 0.2.6
Returns false instead of null to avoid null.toString().
chore(README): polite reminder of guidelines
release 0.2.7
chore(grunt): adds grunt-ngdocs plugin

also integrates it into existing grunt configuration.
this is just the basic stuff, developer guide and tutorial
to come.
docs(ui.router.compat): adds docs for ui.router.compat module
docs(routerProvider): adds docs for routerProvider
docs(urlRouter): adds docs for urlRouter
docs(): wip docs for ui.router.state
docs(state): wip documentation for state service
fix(uiSrefActive): annotate controller injection

 - Fixes #671
docs(state): finishes documentation for state
docs(urlRouter): updates urlRouter docs

replaced the example with a much better one
also improves .sync() method docs
docs(resolve): makes resolve src ngdoc compatible
docs(stateDirectives): first draft docs for stateDirectives
docs(stateFilters): adds docs for state filters
docs($templateFactory): adds docs for $templateFactory
docs(view): adds docs for ui-view and $view