Method links in trait implementations are useless

[SiegeLord]

Consider this section: http://doc.rust-lang.org/std/io/struct.BufWriter.html#implementations None of the methods implemented by this type are documented, and if you click on one of their names, it merely moves the method to the top of the page.

I think the method links should go to the trait's methods, which do have documentation. Alternatively, the documentation could be inlined.

[chris-morgan]

The purpose of this was, I assume, to permit convenient linking to the specific method. A common pattern for permitting this but keeping it out of the way is having a link on the right (or the left for RTL languages), either at the far end or immediately after the text, hidden by default but shown on hover over the heading. The pilcrow (¶) is a common choice for the marker to use for this. https://docs.djangoproject.com/en/dev/ref/settings/ is a simple example of this in practice.

Such a thing would free the actual method text for something else if desired.

[huonw]

Documentation being always inlined is extremely noisy and hard to interpret (especially since many methods, like clone, eq, cmp, very very rarely need independent docs).

[steveklabnik]

Yes, this is for linking to the specific method. We already have issues open about documentation on traits and/or implementations, so I'm giving this a close.