On Wed, Aug 24, 2022 at 7:13 PM Stephen Smoogen ssmoogen@redhat.com wrote:
On Wed, 24 Aug 2022 at 09:08, Fabian Arrotin arrfab@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.