API documentation is terrible

Some related threads which might help: