PaloAltoNetworks / PaloAltoNetworks/docusaurus-openapi-docs
Support showing openapi Links
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 1.1k
- Forks
- 315
- Avg merge
- 7d 5h
- Merged PRs (30d)
- 7
Description
Is your feature request related to a problem?
When the api response is returning an identifier for a field and it is linked to another operation in the schema, I want to show that clearly so that the api users can understand that they can use this response info to fetch more information by calling related/linked operations.
See the open api link specification:
https://spec.openapis.org/oas/latest.html#link-object
And the swaager docs:
https://swagger.io/docs/specification/links/
Describe the solution you'd like
Initially just show the links like swagger docs does:
Later somehow use links to allow staging another operation.
Describe alternatives you've considered
- Provide sub resources directly as nested objects
Additional context
I'm trying to make it easy to explain to users that they can fetch nested information by making another request to fetch sub resources.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reading the OpenAPI Link Object specification and the Swagger links documentation, then inspect how this project currently renders API responses and related operations. Done means generated API documentation visibly shows links from response fields to related operations; the later operation-staging idea is outside the initial scope.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- openapi, react, typescript
- Domain
- documentation
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100