Creates a markdown generator as requested in #4778 (closed).
We had commonly requested documentation generators such as html and asciidoc, and probably less common cwiki and dynamic-html. We do have Markdown docs available for most client/server generators, but we shouldn't require users to research how to extend or customize the generator for such a common and readily available template.
This creates a standalone template to support our focus on ease of usability.
I've marked the generator as beta since it's new.
cc @OpenAPITools/generator-core-team
PR checklist
-
Read the contribution guidelines. -
If contributing template-only or documentation-only changes which will change sample output, build the project before. -
Run the shell script(s) under ./bin/
(or Windows batch scripts under.\bin\windows
) to update Petstore samples related to your fix. This is important, as CI jobs will verify all generator outputs of your HEAD commit, and these must match the expectations made by your contribution. You only need to run./bin/{LANG}-petstore.sh
,./bin/openapi3/{LANG}-petstore.sh
if updating the code or mustache templates for a language ({LANG}
) (e.g. php, ruby, python, etc). -
File the PR against the correct branch: master
,4.3.x
,5.0.x
. Default:master
. -
Copy the technical committee to review the pull request if your PR is targeting a particular programming language.