News for hackers. Stuff that matters.
Re:Rust and the Future of Systems Programming [video] by papaf on Wednesday November 16, 2016 @04:34PM (#12971785)
What are you getting stuck on? I'd love to improve things.

I feel I am getting over the hump of learning rust now and coding in rust is becoming less frustrating for me.

However, one thing that slows me down is the lack of indices in the documentation. For instance, if I want to know the return type of a vector len() I go here:

https://doc.rust-lang.org/std/vec/struct.Vec.html

.. and then I have to search the web page for all instances of "len". It would be good if there was an index similar to Javadoc, Godoc or Doxygen.

There might be a good reason for not having the index, but as a beginner it is lost on me.

Re:Rust and the Future of Systems Programming [video] by steveklabnik on Wednesday November 16, 2016 @04:42PM (#12971852)
Two things:

If you click the little [-] button, you'll get an index for that page.

If you use the search bar at the top, https://doc.rust-lang.org/std/vec/struct.Vec.html?search=vec... will let you go right to the method. (In this case, you have to know that it's slice::len though)

Does that help?

EDIT: UX is hard! Glad people are discovering this. It's the same symbol HN uses, incidentally...

Re:Rust and the Future of Systems Programming [video] by jean- on Wednesday November 16, 2016 @05:30PM (#12972221)
Whoa, I have been working with Rust for a little over a year, and had no idea about the [-] button.

I would echo the suggestions to make that button much more visible. Or perhaps even have the top-level description expanded by default but method/trait descriptions hidden. I can't think of a case where you'd simultaneously want to see every method description.

Re:Rust and the Future of Systems Programming [video] by staticassertion on Wednesday November 16, 2016 @05:31PM (#12972229)
Been using rust for months now and I never knew the [-] did that. I never even thought to click it.

Seems like there's some UX improvements that could happen there.

Re:Rust and the Future of Systems Programming [video] by papaf on Wednesday November 16, 2016 @05:02PM (#12971992)
Thanks, thats very helpful. I did not know about the minus sign.

A polite suggestion - maybe the link marked [-], that takes you to the index, could be labelled "index".

Re:Rust and the Future of Systems Programming [video] by steveklabnik on Wednesday November 16, 2016 @05:23PM (#12972164)
Well, it's not so much that it's an index, it's that when you have a page with only signatures, it feels like an index. There's no redirect, just some JavaScript :)
Re:Rust and the Future of Systems Programming [video] by phaylon on Wednesday November 16, 2016 @06:10PM (#12972491)
Maybe 'collapse' and 'expand' would be good substitutes for the '-' and '+' at the top?