3 ms·
oh please, don't compare python docs to php docs, php docs show one function per page, because their api is WRONG, python shows them often per module level, how
by burnbabyburn 10y ago
oh please, don't compare python docs to php docs, php docs show one function per page, because their api is WRONG, python shows them often per module level, how to compose the api of a module and use them with actual examples, the doc is useful for experienced developers.
I feel this article is advertising their book, maybe the only point to consider is the somewhat broken status of pip that have to deals with system libraries dependencies, but whatever, I still use pip every day and with multiple production deploys.
Is there some good comment about python docs, packaging management, that isn't so much a rant?
- vacri 10y agoThis being said, I find the PHP docs' styling to be easier to read. The python docs are all over the place. This being said, the PHP doc linked to in the article is 15% document, and 85% user comments (why do docs even have user comments?). Yuck.
- iaskwhy 10y agoWhile I understand the idea of not having user comments, back when I was doing php - and remember this was a time without StackOverflow - checking the docs user comments would get me going very quickly as some particular use cases would always show up there (and with improvements from other users too).