As I'm writing more @rustlang, I'm getting frustrated with the disorganization of its documentation. It was a really weird choice to not alphabetize functions in the docs. @elixirlang does this really well. As a beginner its really difficult to find what I'm looking for
-
-
Of course :) The main issue is when I want to see whats available for a module. Its a bit difficult browsing a module and trying to see whats available by name
-
My previous example might not have been that great. Maybe I've been trained this way from two years of working mostly in
@elixirlang, but when I go to a module's documention that I'm not familiar with, I like to scan the available functions/methods and get a feel for the API - 4 more replies
New conversation -
-
-
Yeah but to search you need to know for what. This hurts discoverability. I too have trouble making sense of how the documentation is put together.
-
Sure, that’s why I asked! It seemed like it was “I know the thing I want to find and it’s hard to find”, “I don’t know what I want” is a different, still important, problem.
- 1 more reply
New conversation -
-
-
Is anyone doing anything about the docs for Iterator? It takes 10-15s of loading before I can scroll. I usually back out and search elsewhere.
-
Yes. There’s been a number of patches. Check the nightly docs? If it’s still horrible please file a bug.
- 1 more reply
New conversation -
-
-
Maybe providing an extra "Sort alphabetically" button would make everyone happy.
Thanks. Twitter will use this to make your timeline better. UndoUndo
-
-
-
What's the tradeoff? I also found this fact to be a little weird. I don't mean to have all methods sorted, but sorted in each group i.e. own, trait impl, etc
-
Relevance vs expectations. I try to put the common methods at the top for people who start scanning from the top when they don't know what they want. If you know what you want, search can find it more quickly than scanning a sorted list. Nevertheless I feel bad it's not sorted
- 1 more reply
New conversation -
Loading seems to be taking a while.
Twitter may be over capacity or experiencing a momentary hiccup. Try again or visit Twitter Status for more information.