Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

A distressing number of softwar engineers have overly accurate memories and don't notice when things become excessively cryptic or arcane.

However the implementations being much more open source now means a lot of bad documentation can be overcome with code reading or, if needed, stepping thru the code with a debugger. Wrong documentation is still expensive. I have a bitter taste in my mouth from integrating with OpenTelemetry Go libraries. It seems to be sorted now in 1.27and q 28 but 1.24 and for a few versions the docs were wrong, the examples were not transferable, and it took 5x the time it should have.



Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: