doc, explicit Result types

[jxs]

regarding #16075
currently in std doc there are methods which return Result, which can be confusing at first sight.
Would be great if the function showed upfront the Result<T, E>

[tomjakubowski]

I don't understand what this issue is about. Is it that types like fmt::Result should appear qualified by their module name, because they might be confused with other Result types?

One partial solution might be a pass that walks the crate and finds any types in signatures that have the same name but different definitions (e.g. fmt::Result and result::Result), and figuring out how many levels of path segments are needed to qualify each of their names until there's no ambiguity.

[steveklabnik]

I believe that it's about Result<Foo, Bar> rather than Result<T, E> appearing in type signatures, but I'm not sure.

[tomjakubowski]

Reading the linked issue it looks like my understanding was right. There's another issue like what you're describing (substituting type parameters in default methods) #14072

[alexcrichton]

Yes this issue has to do with prefixes not being displayed, even when they're present in the source. For example you only see Result<usize> here

[steveklabnik]

Triage: no change.

[Mark-Simulacrum]

Closing in favor of #42066; which is more general than this. Thanks!