Re: [Tracker] libmediaart should get a 1.x.y, it's used in production environments that need semver versioning guarantees

[Martyn Russell <martyn lanedo com>]

On 09/09/14 22:20, Philip Van Hoof wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> Under the 0.x.y rules API changes are allowed on semver.org:
>
>         4. Major version zero (0.y.z) is for initial development.
>            Anything may change at any time. The public API should not
>            be considered stable.

Which is where we are and sounds correct to me.

> However, another quote from semver.org's FAQ:
>
>         Q: How do I know when to release 1.0.0?
>
>         A: 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.
>
> Tracker is being used in production and it depends on libmediaart
> 0.5.0 which had a breaking API change with libmediaart 0.4.0.

Yep, I did say that I am going to break APIs and still have some breaks 
to make because the API was not good enough in a number of places.

In terms of the Q/A above, you're probably right, but we're not that 
strict about it. I think it would be remiss of us to do a 1.0.0 release 
if we then change another API in the next few months...

I know on the agenda, there is at least an ASYNC api planned that 
Bastien filed a bug about.

Other than that, I think it's mostly there.

> Which should by now have a libmediaart 1.0.0 and follow semver.org
> versioning rules, as Tracker is a production component depending on
> API stability of libmediaart.

Yea, but Tracker wasn't 1.0.0 for a VERY long time and we didn't worry 
about that either ;)

I would love to roll out a 1.0.0, but I don't think there is time before 
the new releases roll, especially as we have an API freeze.

--
Regards,
Martyn

Founder & Director @ Lanedo GmbH.
http://www.linkedin.com/in/martynrussell