Skip to content
GitLab
Projects Groups Snippets
  • /
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
  • O openapi-generator
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 3,476
    • Issues 3,476
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 402
    • Merge requests 402
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Packages and registries
    • Packages and registries
    • Package Registry
    • Infrastructure Registry
  • Monitor
    • Monitor
    • Incidents
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Repository
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • OpenAPI Tools
  • openapi-generator
  • Issues
  • #4408
Closed
Open
Issue created Nov 07, 2019 by Administrator@rootContributor5 of 6 checklist items completed5/6 checklist items

[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

Assignee
Assign to
Time tracking