I want to expound on my own reasoning behind why pulp_file should be bumped to 1.0 because I realize my original email was probably too brief and I apologize for that.
The thing that I would refer to is semver.org which we've used as a guide for versioning. semver.org defines a 0.Y release as: Major version zero (0.y.z) is for initial development. Anything MAY change at any time. The public API SHOULD NOT be considered stable. Moreover, semver.org has this question/answer: How do I know when to release 1.0.0? If your software is being used in production, it should probably already be 1.0.0. If you have a stable API on which users have come to depend, you should be 1.0.0. If you’re worrying a lot about backwards compatibility, you should probably already be 1.0.0. I think we meet both of these criteria. I expect that Pulp users are probably using pulp_file in production already. In terms of its API, we've had only two small features in the last couple releases of pulp_file since 0.1.0[0] and no major changes to the public API (there was the rename of one field). I don't foresee any major changes to the public api anytime soon. There's not a roadmap for new features either and certainly nothing I see that could cause major changes to pulp_file's API. I think that in this context it makes sense to bump it to 1.0 to communicate to our users that the pulp_file API is stable enough to use in production. Thoughts? [0] https://github.com/pulp/pulp_file/blob/master/CHANGES.rst David On Wed, Apr 22, 2020 at 10:59 AM David Davis <davidda...@redhat.com> wrote: > I feel differently especially when considering that most other Pulp > plugins are at > 1.0. Can you explain why you think pulp_file shouldn't be > at 1.0? > > David > > > On Wed, Apr 22, 2020 at 10:57 AM Brian Bouterse <bmbou...@redhat.com> > wrote: > >> I've seen software live in the < 1.0 area for a long time and graduate >> when it's in broad, production use. That's a difficult thing to assess >> accurately, but to me, pulp_file hasn't reached that point. >> >> >> On Tue, Apr 21, 2020 at 2:20 PM David Davis <davidda...@redhat.com> >> wrote: >> >>> With the next release of pulp_file, I'd propose we bump the version to >>> 1.0. The pulp_file plugin has reached a level of maturity and stability >>> that I think it could be considered production-ready. I've opened a PR to >>> bump the version to 1.0.0: >>> >>> https://github.com/pulp/pulp_file/pull/380 >>> >>> Feedback welcome. I'll set a deadline of April 27, 2020. >>> >>> David >>> _______________________________________________ >>> Pulp-dev mailing list >>> Pulp-dev@redhat.com >>> https://www.redhat.com/mailman/listinfo/pulp-dev >>> >>
_______________________________________________ Pulp-dev mailing list Pulp-dev@redhat.com https://www.redhat.com/mailman/listinfo/pulp-dev