News for hackers. Stuff that matters.
Re:Go Is the New Ruby by mkr-hn on Tuesday October 29, 2019 @08:57AM (#21386572)
For comparison:

https://doc.rust-lang.org/std/fmt/index.html

https://golang.org/pkg/fmt/

I don't know why I find Go's version easier to follow, but I do.

Re:Go Is the New Ruby by steveklabnik on Tuesday October 29, 2019 @11:02AM (#21387912)
Context: I wrote most of the stdlib docs

the fmt docs are... not ideal. That said, there's a lot there, and it's all useful, but it's just tough. Frankly, I just punted on improving them, and haven't taken the time to do so in the years since.

Re:Go Is the New Ruby by mkr-hn on Tuesday October 29, 2019 @12:47PM (#21389218)
It seems like enough people find their way around them. Refinement might make them easier for people like me with less experience navigating language documentation, but that might come at the expense of developing the language. Priorities are important. Especially since Rust doesn't have Google's resources.
Re:Go Is the New Ruby by setr on Tuesday October 29, 2019 @09:40AM (#21386995)
In terms of content, they seem to be on par, and I think it's safe to say that's true for both stdlibs.

Across the ecosystem (and particularly the third-party culture of documentation) is much more important; in my own experience playing with both languages, I tended to encounter more useless 1-line descriptions in golang than I did in Rust.

Also golang struct descriptions always seem to be a bit lackluster..

But I can't point to any particular lib at the moment though.

Re:Go Is the New Ruby by littlestymaar on Tuesday October 29, 2019 @05:22PM (#21392190)
Even if it's not the author's favorite piece of doc, this is still a pretty good example of why I like rust docs. The rust version has :

- syntax highlighting

- a quick example of the feature