[zeromq-dev] About libzmq "domain" inside readthedocs.io

Francesco francesco.montorsi at gmail.com
Tue Oct 31 15:45:36 CET 2023


Hi Brett,

> RTD provides a "custom domain" aka a "subdomain" namespace.   I believe
this would allow
>  zeromq.readthedocs.io/libzmq

yes, I agree it should be feasible.

> I do not know how to best map this to libzmq's development model.

I think Luca has just created the zeromq
https://readthedocs.org/projects/zeromq/  project.
RTD allows to add as many maintainers as needed to a single "project" (like
zeromq)... AFAICT all maintainers have same rights/permissions.
I think it would be best to have all libzmq maintainers added there to
ensure there will be always someone with the rights to update/tweak config
settings also in upcoming years.
And for sure I can be there to help as I can.

Thanks,
Francesco


Il giorno mar 31 ott 2023 alle ore 15:37 Brett Viren <bv at bnl.gov> ha
scritto:

> Francesco <francesco.montorsi at gmail.com> writes:
>
> > In meanwhile perhaps some libzmq maintainer can simply register a new
> > project named "zeromq" and then later on we can setup some kind of
> > redirection rule
>
> RTD provides a "custom domain" aka a "subdomain" namespace.   I
> believe this would allow
>
>   zeromq.readthedocs.io/libzmq
>
> This nicely mirrors GitHub's <org>.githup.io/<repo> namespace for its
> "pages" which naturally gives a spot from other zeromq repos to have
> their docs on RTD.  Though some, at least PyZMQ, already have their own
> subdomain on RTD.
>
>
> The best I can tell from RTD's documentation is that their auth model
> assumes a single individual "owns" the project or subdomain names in the
> namespace.  I do not know how to best map this to libzmq's development
> model.
>
> But, (purely IMO) I think it is reasonable for you, Francesco, to "own"
> the "zeromq" subdomain and "libzmq" project name on RTD.  After all, you
> are the one actively doing the work.  If at some future time you wish to
> transfer ownership you could of course seek someone to take it.  Even
> letting things languish in the future seems okay to me as some future
> interested person can follow the RTD procedure and take over the name
> and the responsibility.
>
>
> -Brett.
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.zeromq.org/pipermail/zeromq-dev/attachments/20231031/8777bd82/attachment.htm>


More information about the zeromq-dev mailing list