| Wei Li Tool I have checked is https://github.com/realm/jazzy It works outside the box - I have tried that on core and synced with documentation team. Laura Fitzgerald I will suggest to redefine this task to provide automation to generate docs. We can done that once and satisfy all future api generation requirements. This can be done by adding simple script to this folder: https://github.com/aerogear/aerogear-ios-sdk/tree/master/scripts This problem also happened on Android: https://issues.jboss.org/browse/AGDROID-671 I guess we need to derisk overall api generation for all platforms and then tickets like this will be not needed, but I'm not convinced if that should happen in the boundary of the single team. Additionally API documentation should not be pushed to the repository etc. It will be generated by automation when gathering documentation from individual repositories. For example: https://github.com/aerogear/aerogear-ios-sdk/tree/master/docs/idm/api Doing that for IDM is ok, but could I suggest to do implement that in such a way so it's done for IDM, but it can cover other modules if needed. |