Great to see the documentation getting an overhaul 
!
There are a couple of things I’m wondering about, though:
- Wouldn’t this be a good time to start replacing the camelCase method names with the snake_case versions in both the manual and the API? If there is no (semi-)automatic way to do this, then I understand your reluctance, although I wouldn’t mind helping out with this (time permitting). The reason I’m mentioning this is that I’m worried about new members getting used to “bad habits” (I’m also thinking here about the built-in global variables) and then, in a couple of months/years/decades, being told that they will have to adapt their (by then potentially quite large) projects, due to these camelCase names becoming deprecated. This might not sit well with them, especially if they learn that the decision to do this was made even before they joined this community (I’m referring to this post in particular).
- When I checked out the new API reference, I noticed that method and property names are no longer listed in alphabetical order, but rather in logical order, I guess. This might be preferable, although it might take some getting used to.
Regardless, I certainly do appreciate all the time and effort you’ve spent working on this!