←back to thread

517 points bkolobara | 7 comments | | HN request time: 0s | source | bottom
Show context
koakuma-chan ◴[] No.45041723[source]
I encourage every one to at least stop writing code in Python.
replies(5): >>45041794 #>>45041941 #>>45042073 #>>45043031 #>>45049992 #
jvanderbot ◴[] No.45041794[source]
The benefits realized can be mostly attributed to strong type checking.

I'm a rust dev full time. And I agree with everything here. But I also want people to realize it's not "Just Rust" that does this.

In case anyone gets FOMO.

replies(1): >>45042106 #
1. koakuma-chan ◴[] No.45042106[source]
Do you know a language other than Rust that has alternative for docs.rs? In JavaScript and Python they never bother to have any documentation or reference, one notable example that gets me frustrated these days is the openai SDK for TypeScript. There is no documentation for it. I have to go look at the source code to figure out what the hell goes on.
replies(3): >>45042173 #>>45043102 #>>45049786 #
2. 9question1 ◴[] No.45042173[source]
These days isn't the solution to this just "ask <insert LLM of choice here>" to read the code and write the documentation"?
replies(2): >>45042354 #>>45043849 #
3. koakuma-chan ◴[] No.45042354[source]
Yes, you can have Claude Code go through the code and make an .md file with documentation for all the public APIs. I do that for everything that doesn't provide llms.txt.
4. cbm-vic-20 ◴[] No.45043102[source]
javadoc.io is similar to (but not as good as) docs.rs for the Java ecosystem. It pulls the JavaDoc out of packages that are published to the Maven Central repository. It doesn't have good discoverability like docs.rs, though, and it's dependent on the publishers actually including the javadoc files.
replies(1): >>45043342 #
5. love2read ◴[] No.45043342[source]
javadoc.io is similar in the fact that it lists things I guess? It looks worse (objective) but is also depended on a lot less so is just by default going to be a second thought. It’s also not auto-generated like docs.rs like you said.
6. bigstrat2003 ◴[] No.45043849[source]
If you want to not reliably know anything about the code, sure. But if you want to have useful knowledge, using a stochastically unreliable tool isn't going to cut it.
7. wolvesechoes ◴[] No.45049786[source]
> In JavaScript and Python they never bother to have any documentation or reference

Please, main Python libraries have much richer docs than almost anything from Rust ecosystem.