From 980d9cd6e97535c9a3613bf712343b04c2d550d6 Mon Sep 17 00:00:00 2001 From: Alexey Rusakov Date: Wed, 15 Jun 2022 06:02:52 +0200 Subject: [PATCH] openapi_extensions.md: fix typos and leftovers (#1128) * openapi_extensions.md: fix typos and leftovers dump-swagger had to substitute things in the past - these days it just merges definitions. * Changelog --- changelogs/client_server/newsfragments/1128.clarification | 1 + openapi_extensions.md | 8 ++++---- 2 files changed, 5 insertions(+), 4 deletions(-) create mode 100644 changelogs/client_server/newsfragments/1128.clarification diff --git a/changelogs/client_server/newsfragments/1128.clarification b/changelogs/client_server/newsfragments/1128.clarification new file mode 100644 index 00000000..3ccb2333 --- /dev/null +++ b/changelogs/client_server/newsfragments/1128.clarification @@ -0,0 +1 @@ +Fix various typos throughout the specification. diff --git a/openapi_extensions.md b/openapi_extensions.md index 6905d663..eba1121c 100644 --- a/openapi_extensions.md +++ b/openapi_extensions.md @@ -12,10 +12,10 @@ To ease API design and management, the API definition is split across several files. Each of these files is self-contained valid OpenAPI. There is no single root file in the source tree as OpenAPI requires; this file -can be generated by `dump_swagger.py` (also doing the substitution mentioned -above). The script does not convert the extensions described further in this -document (`oneOf` and parameter exploding) so there can be minor -interoperability issues with tooling that expects compliant Swagger. +can be generated by `dump-swagger.py`. The script does not convert +the extensions described further in this document (`oneOf` and parameter +exploding) so there can be minor interoperability issues with tooling that +expects compliant Swagger. ## Extensible Query Parameters