docs(*): fix dangling links

[lgalfaso]

Fix many dangling links

[petebacondarwin]

Thanks @lgalfaso - these and the checkAnchors processor you wrote are going to improve the docs a lot.

A number of these fixes are not optimal though. For instance most API entities, such as a service can be referenced in a {@link ... } tag directly or with minimal qualification. So we don't need to resort to real URLs in these cases.

[lgalfaso]

let me look into this later today

[petebacondarwin]

Also I have just refactored parts of and merged your angular/dgeni-packages#78
Do take a look. Great stuff by the way. Thanks again

[lgalfaso]

There are a few pending things outside of this PR

• https://docs.angularjs.org/guide/migration has an item "Modifying the DOM outside digest cycle" that points nowhere (in fact, the answer is not even on that page)
• need to update https://github.com/angular/dgeni-packages/blob/master/ngdoc/templates/api/directive.template.html#L64 so it reads <h2 id="animations">Animations</h2> (this is, to add the id)
• Some small refinements on the dgeni-packages code to detect links

Once dgeni is updated here, there is a need to update the configuration

[petebacondarwin]

@lgalfaso - are these pending things basically just docs things that need fixing or issues with this PR?

[lgalfaso]

@petebacondarwin all the pending things are out of the scope of this PR

[petebacondarwin]

Shall we create new issues for them? (Or did you do that already?)

[lgalfaso]

I just saw that you already fixed some of the issues in your refactor at dgeni-packages. The remaining things are

• fix(ngdocs): Add id to the Animations header for ngdocs dgeni-packages#80
• https://docs.angularjs.org/guide/migration has an item "Modifying the DOM outside digest cycle" that points nowhere

The later point, will open a defect to remove it or for someone to write it

[tbosch]

Closing this based on the discussion above.

[petebacondarwin]

No! The discussion is about things outside of the scope of this PR. This PR still needs to be merged