There is no clear answer about the question how to document Objective-C code. The best way is to use Doxygen. Fred McCann describes this in two blog posts (part 1 and part 2).
Here is described how Xcode 4 snippets make it even easier.
There are also Apple’s HeaderDoc, and Documentation Sets.
