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! -- Matthew Miller <mattdm at fedoraproject.org> Fedora Project Leader