During AGDIGGER-205 I generated JavaDocs for Digger Java client and copy-pasted it into AeroGear website. This is the current approach for API docs in aerogear.org.

1. Would there be a way to link from a specific api to the ios/node equivalent?

Wow, this would be awesome

Of course, the procedure I described above is a very simple approach which doesn't do the awesome stuff paul wright mentions.

Ali Ok has some experience with producing API docs for aerogear digger. He might be able to give us some input here.

In the current website, tutorials/guides are separate from API docs. Tutorials are handcrafted documents but API docs are generated from JavaDocs/JSDocs etc.