Skip to content
GitLab

[Core, HTML2] Rendered docs are incomplete

Closed Administrator requested to merge github/fork/Metaswitch/html2-docs-incomplete into master

Created by: richardwhiuk

PR checklist

  • Read the contribution guidelines.
  • Ran the shell script under ./bin/ to update Petstore sample so that CIs can verify the change. (For instance, only need to run ./bin/{LANG}-petstore.sh, ./bin/openapi3/{LANG}-petstore.sh if updating the {LANG} (e.g. php, ruby, python, etc) code generator or {LANG} client's mustache templates). Windows batch files can be found in .\bin\windows\. If contributing template-only or documentation-only changes which will change sample output, be sure to build the project first.
  • Filed the PR against the correct branch: master, 4.1.x, 5.0.x. Default: master.
  • Copied the technical committee to review the pull request if your PR is targeting a particular programming language.
    • No technical committee for HTML 2.

Description of the PR

  • Simple aliased types are now passed to the generator

  • Body parameters are now provided with their schemas

  • Schema block is now visible in the generated documentation

Note, this changes some of the core behaviour, which doesn't pass aliased models to the generator, so may have large scale impacts.

Changes are by @MalachiJones, @mthebridge, @richardwhiuk and others at @Metaswitch

This fixes https://github.com/OpenAPITools/openapi-generator/issues/1441