[zeromq-dev] State of libzmq versioning

[Doron Somech]

Take a look at readthedocs.org, it is what NetMQ is using and completely
automated. You manage the docs in the git repository.

On Wed, Feb 17, 2016 at 10:41 AM, Pieter Hintjens <ph at imatix.com> wrote:

> 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
> _______________________________________________
> zeromq-dev mailing list
> zeromq-dev at lists.zeromq.org
> http://lists.zeromq.org/mailman/listinfo/zeromq-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.zeromq.org/pipermail/zeromq-dev/attachments/20160217/be1c4226/attachment.htm>