Some suggestion about the current rustdoc

[chmnchiang]

1. Currently, all the folds default to "unfold", so if I want to get a overall view I would have to manually fold all the folds, which I think the opposite is more reasonable: The folds is enabled by default, and let the user click for more details.

2. There are to many [src] floating on the right. Maybe show them only on hovered will be better.

[ghost]

so if I want to get a overall view I would have to manually fold all the folds

Unless I'm misunderstanding something, you can click the "master folder" to collapse all folds:
before:

after:

[GuillaumeGomez]

What's the problem with [src]?

[chmnchiang]

@xftroxgpx That's what I'm looking for, totally missed that. Thanks.

I think the current doc has the problem that it shows to much repeated but uninformative items at a first glance, which cause users hard to get an overview of the page. Take the second picture @xftroxgpx post as an example, at the first sight, those pub fn and src really stand out, which is probably not users are going to looking for. Something like what ruby doc do, which shows link to source only when hover might be better.

Also I think another problem is that too many words are in bold font. For example, those pub fns are much more conspicuous than the function names, which I believe the later are more important to the reader.

[jackh726]

Rustdoc has undergone quite a few updates over the years, and I'm not sure these are even relevant anymore. Closing.