Strangely, the best documentation I've seen so far has been PHP. The only reason: because developers could comment right below the documentation. It's like having StackOverflow right there, in the documentation page.
(Note: I haven't touched PHP since 20 years or so, so not sure if it's still the case).