-
Notifications
You must be signed in to change notification settings - Fork 0
Add API versioning strategy guide #24
Copy link
Copy link
Open
Labels
area: docsDocumentationDocumentationdocumentationImprovements or additions to documentationImprovements or additions to documentationpriority: mediumShould haveShould havesize: mediumHalf day effortHalf day effort
Milestone
Metadata
Metadata
Assignees
Labels
area: docsDocumentationDocumentationdocumentationImprovements or additions to documentationImprovements or additions to documentationpriority: mediumShould haveShould havesize: mediumHalf day effortHalf day effort
Type
Fields
Give feedbackNo fields configured for issues without a type.
Description
Create a guide covering API versioning strategies and how to implement them with Nerva/Hono. The `pipeline.config.json` defines URL-prefix versioning as the default, but users need guidance on the full spectrum of options and when to use each.
Why
API versioning is one of the most debated topics in API design. Nerva takes an opinionated default (URL prefix with `/v1/`), but users need to understand the trade-offs and how to evolve their APIs without breaking consumers.
Acceptance Criteria