[CentOS-devel] Announcing https://sigs.centos.org

Tue Oct 5 15:13:38 UTC 2021
Matthew Miller <mattdm at mattdm.org>

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

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