search

OpenAPITools / openapi-generator

OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (v2, v3)
https://openapi-generator.tech
Apache License 2.0
21.85k stars 6.59k forks source link

[REQ][MARKDOWN] Flat file structure #19941

Open traed opened 3 weeks ago

traed commented 3 weeks ago

Is your feature request related to a problem? Please describe.

Currently the markdown files are sorted into subdirectories (Apis and Models). This does not work if we want to publish the docs as a github wiki since it doesn't support directories. Therefore I suggestion an option to use a flat file structure (all files in the same directory).

Describe alternatives you've considered

Manually moving files after generation and search and replace URL:s to remove the subdirectories, but this seems cumbersome and error prone.

samr874 commented 2 weeks ago

@traed what is the update of this issue please keep updated?

traed commented 2 weeks ago

@samr874 I'm not a maintainer of this project, so I don't have any information of the status.