rustdoc: Remove the brief of structs and traits

[ishitatsuyuki]

Traits and structs brief should be removed: its functionality can be achieved through pressing the [-] button.

Things that are not expressed through the "methods/fields" doucment:

• indication of default implementation on traits: once the brief is removed, we should add an indicator instead to the function line.
• indication of private fields in a struct: we can add a note instead.

Original proposal (superseded)

Current:

pub struct Vec<T> { /* fields omitted */ }

Desired:

pub struct Vec<T> { /* fields omitted */ }

impl<T> Vec<T> {
    fn new() -> Vec<T>;
}

impl<T> IntoIterator for Vec<T>;
impl<T> Index<usize> for Vec<T>;

EDIT: as @sinkuu mentioned below, we have a way to display a well formatted brief by minimizing the descriptions.
We have another option, by removing the brief for traits and advertise the use of [-].

[frewsxcv]

Do you want it to show all available methods and implementations in the code block at the top?

[ishitatsuyuki]

Yeah, scrolling and finding a method is a huge pain for large pages like Vec.

[sinkuu]

So you are ok with all methods listed, then doesn't pushing [-] on top-right of the page give you almost what you want?

[ishitatsuyuki]

@sinkuu didn't noticed that, it's looking quite good. I originally intended to have a similar outlook like the traits; they have methods listed in the block.

I would change the topic to uniforming the two; thanks anyway.

[ishitatsuyuki]

@rust-lang/docs any interest in this?

[GuillaumeGomez]

I have to admit that I don't like the idea... Let's see what others think.

[jsha]

In #83337, we went the other direction: making the decl visible by default in more cases, but hiding its contents when it is very long. I think we should close this, since the consensus in #83337 seemed to go in the other direction.

[GuillaumeGomez]

Agreed. Just for the record: cc @Manishearth