News for hackers. Stuff that matters.

A comment on One year of Rust. Parent comment

Re:One year of Rust by steveklabnik on Monday May 16, 2016 @03:28PM (#11708927)
If you (or anyone really) has specific thoughts here, that'd be super great. Rustdoc's output could use a lot of love, but we haven't figured out exactly what we want to do with it. And having worked with it daily for a few years now, I'm personally a bit blind to its shortcomings.
[ Parent | on HN ]
Re:One year of Rust by Lewisham on Monday May 16, 2016 @03:35PM (#11708981)
Specific thought: Trait implementation pages like http://static.rust-lang.org/doc/master/std/collections/hash_... should output the first paragraph of the documentation text. That way you can easily scan/Ctrl+F through the documentation that's right next to the struct you're interested in. Reduce the number of clicks and context switches.

It's just a pretty terrifying way to output right now.

[ Parent | on HN ]
Re:One year of Rust by steveklabnik on Monday May 16, 2016 @03:45PM (#11709058)
Ah, just saw your edit. So, to be clear about what you mean, you want the Iterator implementation to show the summary line on this page? Seems reasonable to me! I filed a bug: https://github.com/rust-lang/rust/issues/33672

(Also, that page is a bit sparse because I haven't gotten around to writing any docs for it yet, so it's just the autogenerated stuff.)

[ Parent | on HN ]
Re:One year of Rust by Lewisham on Monday May 16, 2016 @04:23PM (#11709316)
Yeah, once you actually get to the text, it's really good and clearly improved from 12 months ago when I last got the free time to play around significantly.

Thanks for the bug ticket :)

[ Parent | on HN ]
Re:One year of Rust by Manishearth on Monday May 16, 2016 @09:28PM (#11710794)
Made a PR: https://github.com/rust-lang/rust/pull/33679
[ Parent | on HN ]