I admit that when I first looked at what appeared to be the Arduino "language" as presented on the reference page it put me off and I went looking at other platforms.
At the time though there weren't any good other platforms (IMO) so I came back to Arduino and delved a bit deeper. Then of course I realized that there are no real restrictions on what you can do, it's just C/C++.
I still reckon that there should be an "advanced user" section(s) to the docs, but like I think everyone else I've given up on anything getting changed in this area.
I haven't looked at the reference for ages, it may have improved but maybe someone into tech pubs could grab what's there and create a PDF language manual or another site/wiki with more advanced docs. I used to do that in a past life but have enough of my own stuff to document these days 
Rob