[CentOS-docs] wiki.centos.org .. what's next ?

Mon Dec 11 09:22:42 UTC 2017
Thibaut Perrin <thibaut.perrin at gmail.com>

Hello Fabien,

First, thank you for even trying for what seems to be an impossible task :(

Quick points :
- if it was decided not to continue, what would happen to the current wiki
? Dismantled or would it remain as read-only for documentation purpose ?
- What about Sphinx <http://www.sphinx-doc.org/en/stable/> ? seems to be
frequentely used nowadays
- As you mentioned, a solution of the type of github with pull requests for
documentation updates might be a solution here.

There is a wiki feature <https://guides.github.com/features/wikis/> on
Github. I don't know to which extend it would fit the needs of the project.

Hope this helps,

Thibaut


On 11 December 2017 at 10:00, Fabian Arrotin <arrfab at centos.org> wrote:

> it's all in the title : what's next for wiki.centos.org ?
>
> As a reminder, current wiki.centos.org instance is powered by moinmoin
> (https://moinmo.in/) but quite an old version (moin-1.5.8-3.el6.noarch)
>
> Recently I had a quick look at trying to update/upgrade that version to
> something newer/supported, but it's a nightmare : the data conversion
> just kill the target server (oom) and no way to know why. When trying to
> get help from moin people in their irc server, I was answered that such
> old version wasn't supported, and that those upgrade scripts themselves
> aren't supported either, so nobody would help finding why they'd be
> buggy without having access to the full data.
>
> Of course exposing the whole wiki instance (including user/pass) isn't
> an option, so except if somebody has really a clue about what can go
> wrong with the update script from 1.5 to 1.6 (and then it has to be done
> for each major.minor upgrade, so all that in a chained operation), the
> migration will be impossible.
>
> That's why I'd like to discuss a possibility to move wiki to something
> else, and that's even why we should discuss the need for a wiki itself.
>
> If we want to continue to have community written/maintained content,
> should be still use a wiki or something else ? Moin was selected ~10y
> ago for its simplicity and online editing, but in 2017, most people (dev
> and ops) are probably using other workflows, like git/pull-requests/etc.
>
> So what about exploring other possibilities ?
>
> I don't have a real proposal (even if mkdocs.org , simple solution with
> Markdown, combined with git would be perfect for me) but just wanted to
> start a dedicated thread so that we can think about the future of
> wiki.centos.org
>
> Opinions ? Proposals ? anything else ? Fee free to comment :-)
>
>
> --
> Fabian Arrotin
> The CentOS Project | https://www.centos.org
> gpg key: 56BEC54E | twitter: @arrfab
>
>
> _______________________________________________
> CentOS-docs mailing list
> CentOS-docs at centos.org
> https://lists.centos.org/mailman/listinfo/centos-docs
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.centos.org/pipermail/centos-docs/attachments/20171211/641b3735/attachment-0006.html>