[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: Thibaut Perrin <thibaut.perrin () gmail ! com>
Date: 2017-12-11 9:22:42
Message-ID: CACR6vxED5N2xpCPwS23d3s057cs=LCgQFFZA3x2WYoKUHxSg4w () mail ! gmail ! com
[Download RAW message or body]
[Attachment #2 (multipart/alternative)]
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@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@centos.org
> https://lists.centos.org/mailman/listinfo/centos-docs
>
>
[Attachment #5 (text/html)]
<div dir="ltr"><div class="gmail_default" style="font-family:trebuchet \
ms,sans-serif">Hello Fabien,</div><div class="gmail_default" \
style="font-family:trebuchet ms,sans-serif"><br></div><div class="gmail_default" \
style="font-family:trebuchet ms,sans-serif">First, thank you for even trying for what \
seems to be an impossible task :(</div><div class="gmail_default" \
style="font-family:trebuchet ms,sans-serif"><br></div><div class="gmail_default" \
style="font-family:trebuchet ms,sans-serif">Quick points : </div><div \
class="gmail_default" style="font-family:trebuchet ms,sans-serif">- 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 ?</div><div class="gmail_default" \
style="font-family:trebuchet ms,sans-serif">- What about <a \
href="http://www.sphinx-doc.org/en/stable/">Sphinx</a> ? seems to be frequentely used \
nowadays</div><div class="gmail_default" style="font-family:trebuchet \
ms,sans-serif">- As you mentioned, a solution of the type of github with pull \
requests for documentation updates might be a solution here. </div><div \
class="gmail_default" style="font-family:trebuchet ms,sans-serif"><br></div><div \
class="gmail_default" style="font-family:trebuchet ms,sans-serif">There is a <a \
href="https://guides.github.com/features/wikis/">wiki feature</a> on Github. I \
don't know to which extend it would fit the needs of the project.</div><div \
class="gmail_default" style="font-family:trebuchet ms,sans-serif"><br></div><div \
class="gmail_default" style="font-family:trebuchet ms,sans-serif">Hope this \
helps,</div><div class="gmail_default" style="font-family:trebuchet \
ms,sans-serif"><br></div><div class="gmail_default" style="font-family:trebuchet \
ms,sans-serif">Thibaut</div><div class="gmail_default" style="font-family:trebuchet \
ms,sans-serif"><br></div></div><div class="gmail_extra"><br><div \
class="gmail_quote">On 11 December 2017 at 10:00, 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 :-)<br>
<span class="HOEnZb"><font color="#888888"><br>
<br>
--<br>
Fabian Arrotin<br>
The CentOS Project | <a href="https://www.centos.org" rel="noreferrer" \
target="_blank">https://www.centos.org</a><br> gpg key: 56BEC54E | twitter: \
@arrfab<br> <br>
</font></span><br>______________________________<wbr>_________________<br>
CentOS-docs mailing list<br>
<a href="mailto:CentOS-docs@centos.org">CentOS-docs@centos.org</a><br>
<a href="https://lists.centos.org/mailman/listinfo/centos-docs" rel="noreferrer" \
target="_blank">https://lists.centos.org/<wbr>mailman/listinfo/centos-docs</a><br> \
<br></blockquote></div><br></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