I, along with a lot of other people, have commented that Apple’s Cocoa documentation needs improvement. As part of Apple’s upcoming December 2001 Developer Tools release, a lot of work has been done to improve the situation.
Matt Rollefson, manager of the Cocoa and Developer Tools Technical Publications Group at Apple, said:
This release includes many small changes (too numerous to list), as well as a substantial reorganization of material. Specifically, it addresses
over 700 method and function descriptions that previously read “description forthcoming”. In addition, substantial amounts of conceptual material that used to be in individual class descriptions have been moved into the Programming Topics hierarchy.
Apparently, the job isn’t quite done. Over the next few months, there will be more work put into completing the reference material. But, from flipping through the documentation I can say that it is much better than it used to be and the writers at Apple should give themselves a pat on the back.