VMelnalksnis / Gnomeshade

Self-hosted personal finance tracker
http://www.gnomeshade.org/
GNU Affero General Public License v3.0
30 stars 5 forks source link

Documentation is not copied to OpenAPI definitions when using `inheritdoc` #1381

Open VMelnalksnis opened 2 weeks ago

VMelnalksnis commented 2 weeks ago

Describe the bug In order to reduce duplicate documentation, inheritdoc is used to copy documentation from API client interfaces to controller endpoints. While it correctly shows up in the IDE, it is used in the OpenAPI definitions, leaving default values.

Additional context Might have to consider migrating to a different package for OpenAPI definition generation.