As briefly mentioned in #198, we actually use TomDoc for our documentation, because we find it much more readable than Appledoc and similar formats.

There's some more discussion about our rationale, and how documentation could be generated, over at ReactiveCocoa/ReactiveCocoa#231.

Ok good to know, I'll close that then. Sorry for the noise.

But, how is documentation generated then ;-) ?

There's currently no way to do so. I think @dannygreg's reply in that other thread addresses it well:

Everything you need is in the header files, there is not (and won't be) anything special about any generated documentation.

That is exactly why we prefer TomDoc, it puts emphasis on making the documentation readable for humans, rather than machines.

Oh, ok. Too bad, Cmd-clicking in Xcode and getting direct DocSet access felt pretty nice to me ;-). I'll go learn the syntax.