Timothée Ravier

Clearing the assignee as I'm not actively working on this.

I agree. Manually updating both the man pages and the docs on GitHub is not ideal. My last attempt at doing automatic conversions have however been unsuccessful thus I settled...

https://alldocs.app/convert-roff-man-to-commonmark > This one gives us the most stable output as far as I could see. The Direct DocBook to CommonMark had some artifacts.

This can probably be easily done in a GitHub Action or as one shot updates via a script that we call each time we do a doc update.

I think you can also create a `man` subfolder in the `docs` one where we can store the generated man pages, one page per manpage to organize things.

See also https://github.com/coreos/coreos-installer/pull/718 for inspiration (GitHub Action, etc.)

See also https://discussion.fedoraproject.org/t/simplifying-updates-for-rpm-fusion-packages-and-other-packages-shipping-their-own-rpm-repos/30364

Oh, thanks a lot for pointing that out and sorry for the noise! Unfortunately I won't be working on that as I don't use GPG but I will leave everything...

/assign travier

Note that this test actively makes a node crash, so I'm not sure how we should account for that in general.