Hello. I was just having a bit of trouble reading the Rustdoc documentation and had a suggestion/observation to improve useability. I am still really new to Rust, but I am liking it a lot.
I was wondering if there was a reason why the Rustdoc documentation template seems to make the function or methods names gray and small font, while the argument lists return values are bolded and in seemingly a larger font. I am not sure if this is true for others, but for me this has the curious effect of making it hard to find the appropriate function or a specific purpose.
Case in point I was looking at the
nalgebra documentation but overlooked a simple method to access individual elements from the matrix datatype. Haha, I actually lost some Stackoverflow reputation points over overlooking this method in the doco.
So just an observation that the Rustdoc template should make the method names or function names in larger font and unbold the rest.
Of course there might be a reason why the Rust developers chose the documentation style that the did. If there is some specific reason, I would appreciate someone sharing it.
I know the developers are busy working on more critical issues. But I figured some noobie feedback might be helpful.