knuckleswtf / knuckleswtf/scribe
OpenAPI spec: Add property descriptions for array fields if they're present in response fields
Open
enhancement
- Dominant language
- PHP
- Stars
- 2.3k
- Forks
- 357
- PR merge metrics
- No merged PRs in 30d
Description
See https://github.com/knuckleswtf/scribe/pull/556
Contributor guide
Research direction
Review pull request #556 first, then trace the OpenAPI response-field generation that produces array fields. Confirm how property descriptions are currently handled and update the relevant behavior so present descriptions appear for array fields; done means the generated OpenAPI spec includes those descriptions.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- laravel, openapi, php
- Domain
- api, documentation
- Issue type
- Feature
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 45/100