On Sat, Oct 02, 2021 at 09:24:08AM +0200, Fabian Arrotin wrote:
We don't use Antora (I don't like it myself but this is my personal opinion so not reflecting the project) even if https://docs.centos.org is built with it (to be clear : we offer the hosting service there, but we don't even build it : it's rendered elsewhere and then pushed to that node)
I definitely understand the preference for Markdown for simple docs. Asciidoc has some weird choices (URL syntax is even uglier than Markdown, which is saying something; handling of formatting and punctuation is a little ungainly, etc.)
It has some really nice features for more complicated docs, and things like Admonitions are super-nice for ... well, computer docs. There are also some things like macros which we don't use enough in Fedora Docs but I'd like to more.
Since I hope docs — and SIG work in general, really — are areas where Fedora and CentOS can increasingly collaborate, I'd really like to see as much working in the same way as possible around these kinds of things!