5 ms·
i always found those comment sections to be so odd — fifteen year old comments about a common pitfall and the information never makes it up to the official docu
by __del__ 4y ago
i always found those comment sections to be so odd — fifteen year old comments about a common pitfall and the information never makes it up to the official documentation?
i suppose it's fitting for a web-centric language to crowd source its docs on a website, but does any other mainstream language do this?
- mxschumacher 4y agoThe php docs are themselves a public GitHub repo, so it's a bit sad if insightful comments don't affect change in the docs
- oneeyedpigeon 4y agoMeanwhile, I find the PHP docs far more readable/accessible than almost any other language. Compared with the official Python or (shudder) Java docs, and they're far superior, IMO.
- cnity 4y agoClojure crowdsources "examples" (to good effect, IMO). For example: https://clojuredocs.org/clojure.core/assoc-in https://clojuredocs.org/clojure.core/assoc-in
- saurik 4y agoIf it makes you feel any better, at least the comments are next to the documentation? Really big projects that people rely on every day -- things like Rust's Cargo or Google's Flutter -- are riddled with bugs and limitations, requiring frustrating boilerplate workarounds to make basic things work correctly, and they generally only have mention of the problems in the comments on the billion 5-10 year old open issues in their task tracker.