Raml documentation using raml2pdf


#1

Hi,

I have tried using raml2pdf to generate documentation for raml . It is well formatted and generates it effectively.

Has anyone else used the tool and can let me know a mechanism to be able to support inline reference to schemas as below:

responses:
200:
body:
application/json:
example: !include samples/getSubProfileResponse.json
schema: !include schemas/getSubProfileResponse.schema.json

In this case there is reference to sample schema and example .

Regards,


#2

Haven’t seen or used that tool before, but shouldn’t the dereferencing of includes be part of the expansion that the parser is doing?