|
|
|
|
|
by bfrog
3424 days ago
|
|
The docs make sense once you get used to them and understand what they're telling you, but it does take some getting used to. The general output of rustdoc could also be improved in my opinion. A bit more summary of available methods/trait impls somewhere would be nice. I'd appreciate a three scrollable pane setup, first pane similar to whats already there on the left, but always visible. Second pane type, usage, examples, methods, impls. Third pane in the middle, widest, actual information in long form. Inline examples of each method are incredibly helpful and the std library docs have quite a few of those but not always. Its sometimes hard to understand how to use a method or type or impl depending on its signature. Panes should scroll+highlight currently viewed items in the actual doc (third) pane. |
|