News for hackers. Stuff that matters.
Re:TypeScript is terrible for library developers by eitland on Wednesday August 24, 2022 @05:55AM (#32577181)
PHP used to have amazing documentation back in the days.

Everything spelled out. No "you must read the whole thing or have worked with it for years to understand page 5".

Plenty of inline examples and even more user submitted ones (although as with all user generated content, some caution should be used when reading those).

Re:TypeScript is terrible for library developers by Tijdreiziger on Wednesday August 24, 2022 @12:12PM (#32581437)
Have we used the same PHP? IME it's usually necessary to read the comments on the documentation for important information, which is frequently totally absent in the actual documentation.
Re:TypeScript is terrible for library developers by eitland on Wednesday August 24, 2022 @12:32PM (#32581850)
Haven't used PHP seriously for a decade I think so I might have a bit of rose tinted glasses.

But I am fairly certain that like the Perl documentation and unlike Java and Spring docs none of them was infuriating.