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