[keycloak-dev] Generating ascii documentation for rest API

Chervine Majeri c.majeri at gmail.com
Wed Jul 19 08:59:12 EDT 2017

Hi everyone,

To program a client (in go) for the rest API, I want to map all the json
representations to structs in the code.
To this end it would be great if there were json schema files to represent
them. But as I understand it, those aren't available (

The next best thing would be to generate the ascii docs and parse those,
rather than go through parsing html directly. But I get errors when I try
to generate the docs in markup using the maven "gen-asciidoc" goal.

Running :

mvn -X -P jboss-release

returns a null pointer exception and a maven mojo failure.

I've checked that the correct versions of swagger2markup are getting

Does anyone else have that behaviour? Or is there some other way of
generating ascii documentation?

My environment is as vanilla as it can get, without any modifications to
the default maven settings.xml (it's pretty much empty except comments).


maven --version output :
Apache Maven 3.3.9 (NON-CANONICAL_2016-07-01T11:53:38Z_mockbuild;
Maven home: /usr/share/maven
Java version: 1.8.0_131, vendor: Oracle Corporation
Java home: /usr/lib/jvm/java-1.8.0-openjdk-
Default locale: en_US, platform encoding: UTF-8
OS name: "linux", version: "4.11.6-201.fc25.x86_64", arch: "amd64", family:

More information about the keycloak-dev mailing list