Comments (4)
I think you're right - but I'm a bit torn on this given how useful this is in development. Maybe we introduce a single "-SNAPSHOT" flag to indicate those are changed? Aligns to how we've done this elsewhere at gilt
from apibuilder.
The snapshot approach seems fine where the iterations are all generated as snapshot and then a single publish occurs for a version number.
from apibuilder.
We should follow semver probably. It is widely used in yhe opensource
community.
I am not sure how semver addresses this specific issue though. I will check.
On May 1, 2014 9:29 AM, "Rob" [email protected] wrote:
The snapshot approach seems fine where the iterations are all generated as
snapshot and then a single publish occurs for a version number.—
Reply to this email directly or view it on GitHubhttps://github.com//issues/5#issuecomment-41909647
.
from apibuilder.
Internally, version is a string. This allows anybody to upload whatever version number they want.
If a version number starts with a "number" followed by "dot" repeated as many times - we can identify that version string and do proper sorting. So users who use semver versioning will get natural, proper ordering.
Users that use different ordering will get maybe wrong ordering but will still work. You can see the tests related to version numbers at:
api/test/lib/VersionSortKeySpec.scala
I think the open question here is at what point do we support locking the interface and no longer accepting changes to the published API. I'm not 100% sure yet what the best workflow for this is so let's leave this issue open for now
from apibuilder.
Related Issues (20)
- Swagger enums are not imported when defined in an array
- Swagger import fails on circular model dependencies
- Create a tutorial for apibuilder setup (+ Update the docker files to workable apibuilder) HOT 3
- Instructions for running service on private kubernetes cluster
- Union Types: Models can belong to different union types with different discriminators HOT 1
- Imported services duplicates in invocation form
- Add schema to https://www.schemastore.org/json/ HOT 5
- API pages: Hyperlinks from models do not work with interface types
- Problem in the example file(api.json)
- Python support
- Swagger: Path definition ignored silently if no 200 response defined
- Add http4s 0.22.x support HOT 1
- Auto authorize membership in API Builder based on GitHub org
- Support OpenAPI3 HOT 4
- Swagger: path definition ignored when unit returned in 2xx response HOT 1
- Add http4s 0.23.x Generator HOT 1
- Union types don't automatically inherit Interface fields during code generation HOT 1
- Unions generation: The operator '[]' isn't defined for the class 'int' HOT 4
- Union type json readers should check discriminator HOT 1
- Will you support $refs like the OpenAPI specification? HOT 1
Recommend Projects
-
React
A declarative, efficient, and flexible JavaScript library for building user interfaces.
-
Vue.js
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
-
Typescript
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
-
TensorFlow
An Open Source Machine Learning Framework for Everyone
-
Django
The Web framework for perfectionists with deadlines.
-
Laravel
A PHP framework for web artisans
-
D3
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
-
Recommend Topics
-
javascript
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
-
web
Some thing interesting about web. New door for the world.
-
server
A server is a program made to process requests and deliver data to clients.
-
Machine learning
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
-
Visualization
Some thing interesting about visualization, use data art
-
Game
Some thing interesting about game, make everyone happy.
Recommend Org
-
Facebook
We are working to build community through open source technology. NB: members must have two-factor auth.
-
Microsoft
Open source projects and samples from Microsoft.
-
Google
Google ❤️ Open Source for everyone.
-
Alibaba
Alibaba Open Source for everyone
-
D3
Data-Driven Documents codes.
-
Tencent
China tencent open source team.
from apibuilder.