On Wed, Aug 24, 2022 at 7:13 PM Stephen Smoogen <ssmoogen at redhat.com> wrote: > > > > On Wed, 24 Aug 2022 at 09:08, Fabian Arrotin <arrfab at centos.org> wrote: >> >> Some time ago, we started to suffer from spammers/load/etc against >> wiki.centos.org >> >> We tried to implement various techniques , found on the moin wiki or >> elsewhere but we have to face it : moin (http://moinmo.in/), then >> underlying app for wiki.centos.org, is now unmaintained. Latest version >> (that we run) is python 2.7 compatible but no plan for python 3, etc, etc >> >> For that reason, some SIGs (including Infra SIG), moved already their >> doc to markdown format, easy to write/review through PR and >> automatically rendered. >> >> The question is so : do we want/need to keep wiki.centos.org running ? >> Most of the content (if not almost 99%) is outdated/unmaintained at this >> stage, and deciding what to do about content , and how/where to migrate >> it would make sense. >> >> That's tied to an old infra ticket open a long time ago >> (https://pagure.io/centos-infra/issue/793) when we had to enabled >> mod_qos, and other workarounds to just try to keep it running and >> functional. >> >> Let's start a thread/discussion ! >> >> @Shaun : as Docs leader, your voice/opinion/feedback would be greatly >> appreciated ;-) > > > I would recommend a markdown with a git backend to cover the differences in documentation. As much as I would like asciidoc, it tends to work only if you have a good docs group keeping track of changes and fixing when asciidoc decides your text was crap. If you have random fixes with people sending mr's which might get merged in ugly ways, markdown seems to handle that nicer. [mainly because it can't do all the cool things asciidoc allows for.] > I second this. Our quick docs could use MkDocs like the SIG stuff does, and the RHELish stuff can use the Antora system the RHEL docs folks want to use. -- 真実はいつも一つ！/ Always, there's only one truth!