I still find it a bit annoying that these docs are not in the source itself. I personally prefer something like http://apidocjs.com where you can write it as comments, only apidoc is still a bit limited.