Re:Why is language documentation still so terrible?
by sshine on Thursday September 12, 2024 @08:30PM
(#41527057)
These append-only community-driven docs were, like PHP itself, an amazing feature in 2001.
The massive amount of garbage and the downvoting wasn't a thing then.
They came when the Internet got populated by normies.
StackOverflow stopped being a fun place to be, too.
Re:Why is language documentation still so terrible?
by sixplusone on Thursday September 12, 2024 @11:49PM
(#41527883)
I believe that the documentation is a huge reason why php became so dominant on the net. Human curated, many real-work examples and helpful comments to get things done.
It's all I needed to learn web dev.
Re:Why is language documentation still so terrible?
by insertchatbot on Thursday September 12, 2024 @09:04PM
(#41527203)
I completely forgot StackOverflow was even a thing. Haven’t used it since ChatGPT 3.5 was released
Re:Why is language documentation still so terrible?
by sshine on Sunday September 15, 2024 @06:04AM
(#41546508)
It was declining years before LLMs.
Re:Why is language documentation still so terrible?
by lifthrasiir on Thursday September 12, 2024 @11:59PM
(#41527930)
Community-driven suggestions are great when they are correct and/or useful enough, which sadly haven't been for years in the case of PHP. I believe the official documentation should have been periodically updated to assimilate suggestions somehow, so that it does cover common use cases and questions but also remains correct and useful enough by curation and possible corrections.
Re:Why is language documentation still so terrible?
by hyperman1 on Friday September 13, 2024 @06:37AM
(#41529870)
That's not even the worst of its sins. The official part of the page is often incomplete, doesn't tell about important edge cases or differences between win and *nix. Also it is regularly flat out wrong.
Sometimes the comments are all screaming about how bad the doc is, then all give an inconsistent variant of the truth.
Re:Why is language documentation still so terrible?
by wodenokoto on Saturday September 14, 2024 @01:04AM
(#41537599)
When I was learning php as a teenager in early 2000' those community examples where the best.
I haven't touched php in forever, but I imagine that the spammers and idiots would ruin that feature.
Re:Why is language documentation still so terrible?
by lofaszvanitt on Saturday September 14, 2024 @02:48AM
(#41537976)
PHP has the best docs available.
When started using Python, oh man, I immediately noticed how much time I wasted because of the horribly structured all over the place docs.
Google also has some of the worst documentation, like on browser extensions.
For those unaware, you can submit example suggestions for functions in PHP. The majority are being down voted for being garbage.