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 pak9rabid on Tuesday November 10, 2020 @01:23PM (#25049209)
For all the hate it gets, I think the way PHP does their documentation is ideal. Easy to search for what you need, it recommends other, similar classes/functions, gives a good description of the inputs and what something is expected to return. Then, in addition to that, there's the user-supplied examples and commentary to help further clarify things. I really like the model they went with.
[ Parent | on HN ]
Re:On Apple's Piss-Poor Documentation by wizzwizz4 on Tuesday November 10, 2020 @02:17PM (#25050267)
I concur. PHP is a horrible language, but I don't hate working in it. The documentation is the reason.
[ Parent | on HN ]
Re:On Apple's Piss-Poor Documentation by ljm on Tuesday November 10, 2020 @03:29PM (#25051468)
I concur and add that PHP has actually evolved quite nicely, and it's horribleness is merely an outdated meme. Java is still playing catchup to the stuff PHP has added in recent years.

Just because it was shit 15 years ago doesn't mean it's still shit now.

[ Parent | on HN ]
Re:On Apple's Piss-Poor Documentation by tonyjstark on Tuesday November 10, 2020 @07:06PM (#25053869)
IMHO there are still some edges that drive you mad until you remember them but the documentation is really good and every release is full of improvements. Also many available frameworks and tools in PHP world are outstanding. For me PHP provides a serious Rapid to Market Edge.
[ Parent | on HN ]
Re:On Apple's Piss-Poor Documentation by Phrodo_00 on Tuesday November 10, 2020 @07:21PM (#25053999)
is the PHP standard library still an inconsistent mess?
[ Parent | on HN ]
Re:On Apple's Piss-Poor Documentation by geerlingguy on Tuesday November 10, 2020 @08:15PM (#25054439)
The inconsistencies are either fully removed (many in 7.x, more in 8.x), deprecated, or at least very well documented these days (e.g. with top level documentation warnings about any potential pitfalls).
[ Parent | on HN ]
Re:On Apple's Piss-Poor Documentation by aszlig on Thursday November 12, 2020 @04:46AM (#25068190)
That's certainly true for the standard library and the documentation on the language itself. However for the internals, this wasn't always the case and it looked more like this:

http://web.archive.org/web/20060626083819/http://www.php.net...

[ Parent | on HN ]
Re:On Apple's Piss-Poor Documentation by elijahparker on Wednesday November 11, 2020 @08:40AM (#25058288)
Agreed -- and the examples in the user comments were invaluable to me way back when I was getting started.
[ Parent | on HN ]