swagger-api / swagger-api/swagger.io-docs
Publish JSON schemas on swagger.io
Open
Nobody has claimed this yet.
- Dominant language
- Astro
- Stars
- 1.6k
- Forks
- 407
- Avg merge
- 2m
- Merged PRs (30d)
- 2
Description
It would be useful to have canonical URIs for JSON schemas for Swagger specifications.
I propose http://swagger.io/schemas/v{version}/schema.json (same path as in the swagger-spec repo).
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 reviewing how the swagger-spec repository currently exposes schema files and how swagger.io-docs publishes content. Confirm the proposed http://swagger.io/schemas/v{version}/schema.json paths for each supported version, then verify that the schemas are reachable at those canonical URIs.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- json
- Domain
- documentation
- Issue type
- Feature
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 35/100