News for hackers. Stuff that matters.

A comment on On Apple's Piss-Poor Documentation. Parent comment

Re:On Apple's Piss-Poor Documentation by rocho on Tuesday November 10, 2020 @03:50PM (#25051720)
> “Here’s the type signature, have fun!”

My experience with Go libraries in a nutshell. One of the factors that made me abandon that language for others that for me are much more productive.

[ Parent | on HN ]
Re:On Apple's Piss-Poor Documentation by EdwardDiego on Tuesday November 10, 2020 @06:22PM (#25053460)
Yeah, I've found that quite often in apps/libs written for K8s in Go - wasn't sure if it was a Go cultural thing or a K8s cultural thing.

If you're lucky you're getting an example or two in the README.md. The rest of the time, you're reading code to figure out the intricacies.

[ Parent | on HN ]
Re:On Apple's Piss-Poor Documentation by rdn on Tuesday November 10, 2020 @11:22PM (#25055481)
At least you can read the code, Apple's libs are closed source. You have to resort to reverse engineering techniques to fill in the documentation gaps.
[ Parent | on HN ]
Re:On Apple's Piss-Poor Documentation by EdwardDiego on Monday November 16, 2020 @10:22PM (#25119960)
That's a very good point. Reminds me of the bad old days of .NET (pre 2.0) where the documentation was a bit shit, and you ended up relying on Reflector to figure out wtf was going on.
[ Parent | on HN ]