Depending on how the pages are generated you should be able to do links and images no problem with Markdown. But yeah not having to update 2 locations would be nice as well as maintain 2 sites one of which is past EOL.

Amy

Amy Marrich

She/Her/Hers

Principal Technical Marketing Manager - Cloud Platforms

Red Hat, Inc

amy@redhat.com

Mobile: 954-818-0514

Slack:  amarrich

IRC: spotz



On Wed, Aug 24, 2022 at 8:57 AM aleksander.baranowski via CentOS-devel <centos-devel@centos.org> wrote:
The Markdown with static site generator FTW.

It's:

- It's easier to contribute
- It's easier to review changes and maintain proper review process
- It's easier to setup
- Deployment/Automation is trivial

One of the problems that might arise is attachments, like images, YT
links etc, and how to maintain them in a repo. But with proper
documentation and rules, it's manageable.

Links like "edit this page" that takes you right into the repository and
source are extremely developer friendly and encourage contributions even
for small things.

The fact that anyone can build/recreate/check changes/experiment locally
is also an important benefit.

Best,
Alex

PS. I used my work e-mail, then tried to "unsent" and waited half-hour,
so if this message goes twice on this mailing-list I'm sorry.

On 8/24/22 15:08, Fabian Arrotin 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 ;-)
>
>
> _______________________________________________
> CentOS-devel mailing list
> CentOS-devel@centos.org
> https://lists.centos.org/mailman/listinfo/centos-devel
_______________________________________________
CentOS-devel mailing list
CentOS-devel@centos.org
https://lists.centos.org/mailman/listinfo/centos-devel