I've always loved the PHP.net site for documentation.
Let's say we wanted to know about the `explode` function, right at the top of their page is a search box. Type in the function and a dropdown populates with a brief description of the function, adding confidence that you're on the right result.
You click the function and right there it gives you the function signature in easily readable text that's color coded. Just at a glance I know that explode will return an array, I must pass it a delimiter first, then the string I want to split and then there is an optional argument in square braces.
If that wasn't enough it goes on to explain each parameter down below as well as the return values.
Further down is the change log on what changed between versions.
Next up are what really makes the PHP documentation shine for me: examples.
Succinct and to the point examples with comments that have always been enough to get me started with the basics.
This would have been good enough, but they go a step further to give me related functions in the "See Also" section. Sometimes I'm looking for one function, but then find a function that can do it better, or I realize that hey after I perform this action, I'm probably going to need to use another one of these related functions such as the `implode` function.
User comments at the bottom are also great! They are usually insightful and have been very helpful in the past.
The writing for classes and extensions is also equally as good: well written, quick start guides, installation settings for Windows and Linux.
I've always felt that the website was very user friendly and accessible. When you go to the landing page you're not overwhelmed with information. Just a quick blurb about what PHP is, the news of releases, easy to find download options, and documentation and search are all above the fold and prominently featured.
One of the really nice things about PHP.net in particular is that you can go to any function name as a root directory on the website and it will look it up, e.g. http://php.net/explode will go right to the explode doc. This works for root functions as well as classes and most keywords.
Let's say we wanted to know about the `explode` function, right at the top of their page is a search box. Type in the function and a dropdown populates with a brief description of the function, adding confidence that you're on the right result.
You click the function and right there it gives you the function signature in easily readable text that's color coded. Just at a glance I know that explode will return an array, I must pass it a delimiter first, then the string I want to split and then there is an optional argument in square braces.
If that wasn't enough it goes on to explain each parameter down below as well as the return values.
Further down is the change log on what changed between versions.
Next up are what really makes the PHP documentation shine for me: examples.
Succinct and to the point examples with comments that have always been enough to get me started with the basics.
This would have been good enough, but they go a step further to give me related functions in the "See Also" section. Sometimes I'm looking for one function, but then find a function that can do it better, or I realize that hey after I perform this action, I'm probably going to need to use another one of these related functions such as the `implode` function.
User comments at the bottom are also great! They are usually insightful and have been very helpful in the past.
The writing for classes and extensions is also equally as good: well written, quick start guides, installation settings for Windows and Linux.
I've always felt that the website was very user friendly and accessible. When you go to the landing page you're not overwhelmed with information. Just a quick blurb about what PHP is, the news of releases, easy to find download options, and documentation and search are all above the fold and prominently featured.