Add descriptions to OpenAPI arguments that contain "magic numbers" #172

Closed
opened 2025-06-07 17:37:59 +00:00 by itzaname · 0 comments
Owner

I shouldn't have to dig through the source code to figure out what Sort=3 means or StatusID=4 means. OpenAPI spec allows descriptions so document these values there.

Example with Sort

image.png
I shouldn't have to dig through the source code to figure out what Sort=3 means or StatusID=4 means. OpenAPI spec allows descriptions so document these values there. Example with Sort <img width="456" alt="image.png" src="attachments/c0033fea-b0d7-4251-9f3a-c153094d94ff">
184 KiB
itzaname added the enhancement label 2025-06-07 17:37:59 +00:00
Quaternions was assigned by itzaname 2025-06-07 17:37:59 +00:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: StrafesNET/maps-service#172