[zeromq-dev] ZeroMQ docs

[Brett Viren]

On Fri, Oct 20, 2023 at 12:03 PM Francesco <francesco.montorsi at gmail.com> wrote:
>
> Maybe an even simpler solution is to activate the Github "Pages" support in libzmq.org and link it with a github action that just uses the Asciidoctor generator to convert all of doc/*.txt into static HTML.
>
> What do you think about this?

This sounds like a very good idea to me.  And, it's even easier as the
existing libzmq build already produces the HTML.

On could prototype some additional build action that populate the
special gh-pages by committing these generated HTML files.  This can
be tested using a personal fork of libzmq to make your own
https://<name>.github.io/libzmq/.  When that works, a PR to libzmq
would be needed.  Bonus if some .github/ CI bits could automate this.
And, someone with GitHub permissions would need to go into libzmq's
repo settings to turn on the publish setting.

-Brett.