Hi Francesco, I agree a refresh of the online API docs would be good. I think the zeromq.org website takes its content from:
https://github.com/zeromq/zeromq.org A PR to that repo is likely the first step to get zeromq.org updated. It would be extra good if the API docs for development and releases could be refreshed in a more automated way. I personally like having all the documentation under *.zeromq.org but I see benefit and no downside to also having a copy of the API docs served from readthedocs. The current API documentation source files are in AsciiDoc format under libzmq/doc/*.txt and there are HTML and Unix man page build targets. These should of course be retained. Readthedocs suggests a procedure to build from AsciiDoc sources. https://docs.readthedocs.io/en/stable/build-customization.html#asciidoc Perhaps a PR to libzmq that adds something under libzmq/.github/ is the path to get this new API doc target working? -Brett. On Fri, Oct 20, 2023 at 6:09 AM Francesco <[email protected]> wrote: > > Another point I forgot: I think it would be nice to switch to > https://about.readthedocs.com/ as a way to publish the libzmq API... > > > Il giorno ven 20 ott 2023 alle ore 12:00 Francesco > <[email protected]> ha scritto: >> >> Hi all, >> I'm happy to see that version 4.3.5 has been published, thanks Luca and all >> other contributors for making that happen! >> >> However I noticed that http://api.zeromq.org/master:_start is still >> mentioning version 4.3.2 of the API. >> >> Do you think it's possible to get there updated docs? >> If there is any work to be done, I can try to help the best I can... >> >> Thanks, >> Francesco >> >> > _______________________________________________ > zeromq-dev mailing list > [email protected] > https://lists.zeromq.org/mailman/listinfo/zeromq-dev _______________________________________________ zeromq-dev mailing list [email protected] https://lists.zeromq.org/mailman/listinfo/zeromq-dev
