Do you want to request a feature or report a bug?
Docs issue

What is the current behavior?
On the docs of directives which include the animation section, arguments are shown as a h3 element below the animation's h2 element, making it look like it's a subsection of animations.

Example: https://docs.angularjs.org/api/ng/directive/ngClass

What is the expected behavior?
Arguments sounds like a subsection of Usage. Moving the animation section (https://github.com/angular/angular.js/blob/master/docs/config/templates/ngdoc/api/directive.template.html#L64) to the end of the file, right before the last endblock would render the arguments h3 element after the usage h2 element.

I added a PR to demonstrate the change I'm talking about, but I'm more than happy to change the PR according to what gets discussed here.