[BUG] [AsciiDoc] Names of the parameters are not preserved
Created by: mgwoj
Bug Report Checklist
-
Have you provided a full/minimal spec to reproduce the issue? -
Have you validated the input using an OpenAPI validator (example)? -
What's the version of OpenAPI Generator used? -
Have you search for related issues/PRs? -
What's the actual output vs expected output? -
[Optional] Bounty to sponsor the fix ([example]
Description
Documentation generated in AsciiDoc format has invalid parameter names.
If the parameter name is like X-Some-Param
, in the generated index.adoc
file it looks like xSomeParam
, which is wrong. Original name should be preserved.
openapi-generator version
2.4.1-SNAPSHOT
OpenAPI declaration file content or url
openapi: 3.0.0
info:
title: Some API
version: 0.0.1
paths:
/v1/api/view/:
get:
responses:
'200':
description: OK
parameters:
- name: X-Some-Param
in: header
required: true
schema:
type: integer
Command line used for generation
generated via gradle plugin
Steps to reproduce
Generated, wrong content
====== Header Parameters
[cols="2,3,1,1,1"]
|===
|Name| Description| Required| Default| Pattern
| xSomeParam
|
| X
| null
|
|===
Related issues/PRs
None
Suggest a fix
Change file openapi-generator\modules\openapi-generator\src\main\resources\asciidoc-documentation\param.mustache
and replace paramName
with baseName
/CC: @man-at-home