I second  Mediawiki, however we should have a discussion on the migration plan.<br>Thanks<br>Allamiro<br><div class="gmail_quote"><div dir="ltr">On Wed, Dec 13, 2017 at 1:50 PM Brian Exelbierd <<a href="mailto:bex@pobox.com">bex@pobox.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On Mon, Dec 11, 2017, at 10:41 AM, Fabian Arrotin wrote:<br>
> On 11/12/17 10:22, Thibaut Perrin wrote:<br>
> > Hello Fabien,<br>
> ><br>
> > First, thank you for even trying for what seems to be an impossible task :(<br>
> ><br>
> > Quick points : <br>
> > - if it was decided not to continue, what would happen to the current<br>
> > wiki ? Dismantled or would it remain as read-only for documentation<br>
> > purpose ?<br>
> > - What about Sphinx <<a href="http://www.sphinx-doc.org/en/stable/" rel="noreferrer" target="_blank">http://www.sphinx-doc.org/en/stable/</a>> ? seems to be<br>
> > frequentely used nowadays<br>
> > - As you mentioned, a solution of the type of github with pull requests<br>
> > for documentation updates might be a solution here. <br>
> ><br>
> > There is a wiki feature <<a href="https://guides.github.com/features/wikis/" rel="noreferrer" target="_blank">https://guides.github.com/features/wikis/</a>> on<br>
> > Github. I don't know to which extend it would fit the needs of the project.<br>
> ><br>
> > Hope this helps,<br>
> ><br>
> > Thibaut<br>
><br>
> So far there is no decision, reason why I started this thread :)<br>
> I guess our target would be to convert (and sanitize ?) existing content<br>
> anyway as we don't want to lose such content. Then either replacing<br>
> <a href="http://wiki.centos.org" rel="noreferrer" target="_blank">wiki.centos.org</a> with new solution (but trying to keep the same structure<br>
> so that all the things in cache for search engines and/or articles<br>
> pointing to wiki can still work) or move to something different and<br>
> indeed keeping existing <a href="http://wiki.centos.org" rel="noreferrer" target="_blank">wiki.centos.org</a> in Read-Only mode<br>
<br>
We've been working on a similar project in Fedora.  We have started by<br>
migrating the top doc pages out of our wiki and into a Pagure (git forge<br>
at <a href="http://pagure.io" rel="noreferrer" target="_blank">pagure.io</a> that we use and you're welcome to join us on) repository<br>
that can be used by our <a href="http://docs.fedoraproject.org" rel="noreferrer" target="_blank">docs.fedoraproject.org</a> builder.  We then marked<br>
these new pages as drafts because many need updates (a problem it sounds<br>
like you won't have).  In the wiki we put redirect links to the new<br>
pages on the docs website.<br>
<br>
> I'd like to avoid Github specifically but having something else that<br>
> would permit to use ACO (<a href="https://acccounts.centos.org" rel="noreferrer" target="_blank">https://acccounts.centos.org</a>) as auth source. I<br>
> already played with gitea and it works with openid so self-hosted git<br>
> instance using ACO works fine. (but that's a different thread)<br>
<br>
/me whispers *Pagure* :P<br>
<br>
> We should divide all parts into specific areas. Benefits of using .md<br>
> means being able to switch to something else even later and not be tied<br>
> to $yet_another_tool to generate the web part. (just my idea)<br>
<br>
We are using AsciiBinder to build our docs site.  I realize this is<br>
$yet_another_tool, but it is one that several other projects in our<br>
ecosystem and sponsor system are using.  The upstream is amenable to<br>
patches, if needed.  It is opinionated, so you have to decide what<br>
you're willing to let go of and what is a "line in the sand."  One of<br>
those opinions, today, is the use of AsciiDoc.  I have a PoC to use<br>
other markups, but it is not complete.<br>
<br>
Let me know if any details on what Fedora is doing would be helpful.<br>
I'd like to see us work more closely on documentation, especially now<br>
that CentOS SIGs are often building bits that are closer to Fedora than<br>
to CentOS core (as I understand it).<br>
<br>
regards,<br>
<br>
bex<br>
_______________________________________________<br>
CentOS-docs mailing list<br>
<a href="mailto:CentOS-docs@centos.org" target="_blank">CentOS-docs@centos.org</a><br>
<a href="https://lists.centos.org/mailman/listinfo/centos-docs" rel="noreferrer" target="_blank">https://lists.centos.org/mailman/listinfo/centos-docs</a><br>
</blockquote></div>