Many things cannot be found in the API reference but can be found is the source code header. However, the source code header is poorly commented, and I have to guess the intended usage of object based on their name and my intuition. Sometimes it works, sometimes it does not. It's hard to call the interface and error prone. It's also hard to search an object in multiple header files - I have to guess which file it is. It will be easier to CTRL+F in a single document.
The documentation also contains many usages that is not included in the API. I assume these are legacy usages that have been removed.
Documentation and API reference seems need to be updated
What runtime are you using?
Our generic documentation should map pretty closely with all runtimes. Can you give an example or two of the issues you encountered?