[zeromq-dev] State of libzmq versioning

[Pieter Hintjens]

Hmm, the tools we use to build the online docs are old and creaky, and
date from long before we had neat CI automation. Meaning, we update
the api site manually.

I'm doing that now. I think it's time we look at pushing this directly
to github pages, from Travis.

On Wed, Feb 17, 2016 at 12:47 AM, Mario Steinhoff
<steinhoff.mario at gmail.com> wrote:
> Hi everyone,
>
> I am a bit confused about the available information on libzmq versions.
>
> The page at api.zeromq.org says that we have:
>
> - 4.2 (master)
> - 4.1 (rc)
> - 4.0 (stable)
> - 3.2 (stable)
>
> On the download page 4.0 is missing:
>
> - a version-less master which "should be stable almost all the time" (4.2?)
> - 4.1.4 ("stable")
> - 3.2.5 ("legacy stable")
>
> In libzmq, the NEWS file on master seems to be outdated (last update
> in 2014). The doc folder in libzmq seems to be maintained but not in
> sync with api.zeromq.org (I checked today and some changes from the
> last commit in that folder are not present on the site).
>
> There are also maintained stabilization forks as per C4.1 for libzmq,
> e.g. zeromq4-x (which contains 4.0?), 4-1, and 3-x (which contains
> 3.2?).
>
> And then there is this article: http://hintjens.com/blog:85 which
> suggests in a very compelling way that software versions suck and to
> ditch them altogether (yes I agree) but I can't find those SBOMs
> anywhere so I assume that experiment did not went very far.
>
> With all this, whats the current status on libzmq versioning?
>
> Am I understanding right that:
>
> - The libzmq repository is always the latest and greatest, and 4.2
> looks like the last version I'll ever need™, its always stable and
> follows the raw-draft-stable-deprecated process so its also always
> backwards compatible.
>
> - Stable releases are maintained for 3.2, 4.0, and 4.1 and sometimes
> bugfixes get backported from 4.2.
>
> - Release notes are only maintained for stable releases?
>
> Is the outdated API site a bug or a feature? I am currently using the
> text files in doc/ but I like to look at the fancy ZMQ logo when I
> browse the API reference :-)
>
> Cheers
> Mario
> _______________________________________________
> zeromq-dev mailing list
> zeromq-dev at lists.zeromq.org
> http://lists.zeromq.org/mailman/listinfo/zeromq-dev