Make a html page for openapi

Descriptive title for this enhancement

Build a documentation for openapi

Actual behavior

No documentation

Expected behavior

A nice documentation

Benefits

Easy reading

Possible Drawbacks

None

changed milestone to %FusionDirectory 1.4

added PJ1802-0188 user-manual labels

I tried with these applications:

• https://github.com/fmvilas/openapi3-generator

It made an .md file but doxygen could not use it and same with pandoc the html was not very nice

• https://github.com/contentjet/openapi-ui

It's more like a reader of openapi.yaml and it use nodejs (it's also a webserver)

• https://openapi-generator.tech/docs/installation

It use nodejs (wrapper) and a java application but it's possible to build a html page that we can host somewhere (html / html2 and dynamic). I find html2 pretty clean.

To make a convert use this command

# dynamic may be change with html or html2
# npx openapi-generator will show the list of all generators
npx openapi-generator generate -i ../openapi.yaml -g dynamic-html -o dynamic --skip-validate-spec

added 4h of time spent at 2019-04-30

mentioned in issue dev-manual#27 (closed)

closed

removed user-manual label

added plugin-webservice label