Add id values to rustdoc source view for convenient linking

[jdm]

It would be really nice to provide stable links in the source view for generated documentation. I envision providing ids for thinks like data types and function names, and perhaps method implementations; these would need to remain stable as long as the type names involved did not change.

[jdm]

As an example, http://doc.servo.org/src/script/dom/document.rs.html#struct-Document could link to the opening line of the declaration of the Document struct, by changing <span class='ident'>Document</span> to <span class='ident' id='struct-Document'>Document</span>.

[steveklabnik]

Triage: no change

[steveklabnik]

The line number is linkable; it's not quite the same thing. @rust-lang/rustdoc is this a feature we'd consider adding? It seems like a marginal improvement to me.

[GuillaumeGomez]

Ids have been somewhat stable for quite some time now, aren't they?

[steveklabnik]

Not in the source view, right?

…

On Sep 24, 2018, at 3:21 PM, Guillaume Gomez ***@***.***> wrote: Ids have been somewhat stable for quite some time now, aren't they? — You are receiving this because you commented. Reply to this email directly, view it on GitHub, or mute the thread.

[GuillaumeGomez]

In the source view, the ids are literally line numbers.

[steveklabnik]

Right, this ticket is asking for

I envision providing ids for thinks like data types and function names, and perhaps method implementations;

in addition to that.

[GuillaumeGomez]

I have difficulties to understand what need it would fulfil...

[jdm]

Me too! No need to debate this further; github links to specific revisions work fine.