doc: remove over-explanation #29460
doc: remove over-explanation #29460
Conversation
|
(rust_highfive has picked a reviewer for you, use r? to override) |
| @@ -2553,10 +2553,7 @@ pub trait Extend<A> { | |||
| /// | |||
| /// # Examples | |||
| /// | |||
| /// Basic usage: | |||
There was a problem hiding this comment.
This is becoming more common throughout the standard library as I go through things, so it should stay.
There was a problem hiding this comment.
Seems not needed since there is no "Advanced usage" example
There was a problem hiding this comment.
I would call it consistency if it was everywhere, but it isn't.
There was a problem hiding this comment.
I would also remove all those instances, unless they were accompanied with "Advanced usage" examples.
There was a problem hiding this comment.
As I go through the docs, I'm adding them, so this will become gradually so over time.
|
☔ The latest upstream changes (presumably #29509) made this pull request unmergeable. Please resolve the merge conflicts. |
|
I think I'm 👎 on this PR overall. Extra explanation is good. Docs don't have to be terse. |
No description provided.