api docs generation

done for [AGIOS-323](https://issues.jboss.org/browse/AGIOS-323)

@corinnekrych mind to review? the new look is awesome! ;)  jazzy++