Incomplete/Missing API documentation

While trying to find a way to phase out CoreAPI from the codebase, I found that it's used to create autmatic API documentation but I've noticed that it's used mostly in just one file. This means that, for other parts of the API, there seems to be no documentation. It would be great to do a writeup on some of the parameters, preferably after CoreAPI is removed from the project.