docs: header links are not working

[Splaktar]

Bug, enhancement request, or proposal:

Bug

Detailed Reproduction Steps:

1. Open https://material.angularjs.org/latest/api/service/$mdDateLocaleProvider
2. Find the formatDate header
3. Click on the header and it seems to update the URL properly to https://material.angularjs.org/latest/api/service/$mdDateLocaleProvider#mddatelocaleprovider-formatdate but it also seems to scroll that item off of the screen
4. Hover over the header and it displays an invalid URL https://material.angularjs.org/latest/#mddatelocaleprovider-formatdate which makes it hard to send a link to a specific part of the docs to someone for reference

What is the expected behavior?

Linking to headers in the docs should work properly and navigate the user to the proper section of the docs.

What is the current behavior?

The header links often bring the user to the wrong part of the correct docs page or they just take the user to the AngularJS Material home page instead of the specific part of the docs that was intended.

What is the use-case or motivation for changing an existing behavior?

Meet user expectations when using the docs.

Which versions of AngularJS, Material, OS, and browsers are affected?

• AngularJS: 1.6.9
• AngularJS Material: 1.1.9
• OS: all
• Browsers: all

Is there anything else we should know? Stack Traces, Screenshots, etc.

This may be an issue with how we're generating the docs with the new dgeni. Either we may need to change something about how we're annotating them or dgeni may need to be fixed.