News for hackers. Stuff that matters.
Re:TypeScript is terrible for library developers by rhacker on Tuesday August 23, 2022 @07:24PM (#32572912)
C#, C++, Java (actually I am betting no one can beat that one)

I think you dismissed the actual issue he faced- gen type defaults, which I just looked is still not actually documented, it's just in the release notes.

Don't get me wrong, TS is my favorite language, but let's not gloss over things.

Re:TypeScript is terrible for library developers by philliphaydon on Tuesday August 23, 2022 @09:18PM (#32573883)
My career has been 95% c#.

Recently learning rust (spare time) and c++ for work. The documentation for these 2 are awesome!

PostgreSQL has great docs too

I think we are better at writing docs for programming languages than we are at libraries and frameworks. Maybe because languages are more ‘fixed’ and less likely to change so over time they just get better and better.

Re:TypeScript is terrible for library developers by inferiorhuman on Wednesday August 24, 2022 @03:25AM (#32575948)
You picked two of the best documented projects around in Rust and PostgreSQL. I don't think that inferior documentation for libraries is a foregone conclusion. Rust's serde library is exceptionally well documented IMO.

It's a matter of having the skill and the will though, and I feel like a lot of projects simply don't emphasize documentation. Even so, not everyone's going to be a good technical writer.

Re:TypeScript is terrible for library developers by philliphaydon on Wednesday August 24, 2022 @04:17AM (#32576312)
What I mean is I think in general languages tend to have better docs.

Vue has excellent docs imo.

But in terms of technical writing being a skill. I agree. I appreciate the effort people put into docs. I try my best but I’m not very good. So I have a lot of respect for anyone who can sit and write excellent docs.

Re:TypeScript is terrible for library developers by inferiorhuman on Wednesday August 24, 2022 @07:34PM (#32587318)
It's been a long time since I've dug for C++ docs but in general I found Qt to be well documented (if a bit disorganized with the newer stuff). STL documentation always seemed inaccessible to me, but then again I'm working off of some pretty hazy memories.
Re:TypeScript is terrible for library developers by jacobr1 on Thursday August 25, 2022 @11:53AM (#32595470)
Commercially supported software Qt (and in the parent post, Vue) tend to have good docs. It makes sense: supporting developers is their business model. Likewise tools with ecosystems of companies (postgresql) tend to get good docs over time. The bigger pain points are tools supported by a major company ... but that used by the business rather than sold. There probably are _some_ good docs - especially at the project launch or major milestones - but they aren't as actively curated.