[prev in list] [next in list] [prev in thread] [next in thread]
List: centos-docs
Subject: Re: [CentOS-docs] wiki.centos.org .. what's next ?
From: Akemi Yagi <amyagi () gmail ! com>
Date: 2017-12-12 16:25:33
Message-ID: CABA31Dq3YdNpPMcHgrHXWu-=9dRjiiOHqw+_LFCg_yyP7ajMrQ () mail ! gmail ! com
[Download RAW message or body]
[Attachment #2 (multipart/alternative)]
On Mon, Dec 11, 2017 at 1:00 AM, Fabian Arrotin <arrfab@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 :-)
I personally would like to see an update to the current wiki. However if
this is not plausible, maybe an alternative like mediawiki can be
considered?
One note I want to make is that use of git may not be suitable/best for
docs and certainly will be frowned upon by some notable contributors to the
current wiki.
Akemi
[Attachment #5 (text/html)]
<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On Mon, Dec 11, 2017 \
at 1:00 AM, Fabian Arrotin <span dir="ltr"><<a href="mailto:arrfab@centos.org" \
target="_blank">arrfab@centos.org</a>></span> wrote:<br><blockquote \
class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc \
solid;padding-left:1ex">it's all in the title : what's next for <a \
href="http://wiki.centos.org" rel="noreferrer" target="_blank">wiki.centos.org</a> \
?<br> <br>
As a reminder, current <a href="http://wiki.centos.org" rel="noreferrer" \
target="_blank">wiki.centos.org</a> instance is powered by moinmoin<br> (<a \
href="https://moinmo.in/" rel="noreferrer" target="_blank">https://moinmo.in/</a>) \
but quite an old version (moin-1.5.8-3.el6.noarch)<br> <br>
Recently I had a quick look at trying to update/upgrade that version to<br>
something newer/supported, but it's a nightmare : the data conversion<br>
just kill the target server (oom) and no way to know why. When trying to<br>
get help from moin people in their irc server, I was answered that such<br>
old version wasn't supported, and that those upgrade scripts themselves<br>
aren't supported either, so nobody would help finding why they'd be<br>
buggy without having access to the full data.<br>
<br>
Of course exposing the whole wiki instance (including user/pass) isn't<br>
an option, so except if somebody has really a clue about what can go<br>
wrong with the update script from 1.5 to 1.6 (and then it has to be done<br>
for each major.minor upgrade, so all that in a chained operation), the<br>
migration will be impossible.<br>
<br>
That's why I'd like to discuss a possibility to move wiki to something<br>
else, and that's even why we should discuss the need for a wiki itself.<br>
<br>
If we want to continue to have community written/maintained content,<br>
should be still use a wiki or something else ? Moin was selected ~10y<br>
ago for its simplicity and online editing, but in 2017, most people (dev<br>
and ops) are probably using other workflows, like git/pull-requests/etc.<br>
<br>
So what about exploring other possibilities ?<br>
<br>
I don't have a real proposal (even if <a href="http://mkdocs.org" \
rel="noreferrer" target="_blank">mkdocs.org</a> , simple solution with<br> Markdown, \
combined with git would be perfect for me) but just wanted to<br> start a dedicated \
thread so that we can think about the future of<br> <a href="http://wiki.centos.org" \
rel="noreferrer" target="_blank">wiki.centos.org</a><br> <br>
Opinions ? Proposals ? anything else ? Fee free to comment :-)<span \
class="HOEnZb"><font color="#888888"></font></span></blockquote><div><br><div \
style="font-family:monospace,monospace;display:inline" class="gmail_default">I \
personally would like to see an update to the current wiki. However if this is not \
plausible, maybe an alternative like mediawiki can be considered?<br><br></div><div \
style="font-family:monospace,monospace;display:inline" class="gmail_default">One note \
I want to make is that use of git may not be suitable/best for docs and certainly \
will be frowned upon by some notable contributors to the current \
wiki.<br><br></div><div style="font-family:monospace,monospace;display:inline" \
class="gmail_default">Akemi<br></div></div></div></div></div>
_______________________________________________
CentOS-docs mailing list
CentOS-docs@centos.org
https://lists.centos.org/mailman/listinfo/centos-docs
[prev in list] [next in list] [prev in thread] [next in thread]
Configure |
About |
News |
Add a list |
Sponsored by KoreLogic