[CentOS-devel] What to do with wiki.centos.org ? (let's discuss it)

Wed Aug 24 23:12:24 UTC 2022
Stephen Smoogen <ssmoogen at redhat.com>

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.]


-- 
Stephen Smoogen, Red Hat Automotive
Let us be kind to one another, for most of us are fighting a hard battle.
-- Ian MacClaren
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.centos.org/pipermail/centos-devel/attachments/20220824/32e78469/attachment-0003.html>