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

Wed Dec 13 18:17:53 UTC 2017
Tamir allamiro <allamiro at gmail.com>

I second Mediawiki, however we should have a discussion on the migration
plan.
Thanks
Allamiro
On Wed, Dec 13, 2017 at 1:50 PM Brian Exelbierd <bex at pobox.com> wrote:

> On Mon, Dec 11, 2017, at 10:41 AM, Fabian Arrotin wrote:
> > On 11/12/17 10:22, Thibaut Perrin wrote:
> > > 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
> >
> > So far there is no decision, reason why I started this thread :)
> > I guess our target would be to convert (and sanitize ?) existing content
> > anyway as we don't want to lose such content. Then either replacing
> > wiki.centos.org with new solution (but trying to keep the same structure
> > so that all the things in cache for search engines and/or articles
> > pointing to wiki can still work) or move to something different and
> > indeed keeping existing wiki.centos.org in Read-Only mode
>
> We've been working on a similar project in Fedora.  We have started by
> migrating the top doc pages out of our wiki and into a Pagure (git forge
> at pagure.io that we use and you're welcome to join us on) repository
> that can be used by our docs.fedoraproject.org builder.  We then marked
> these new pages as drafts because many need updates (a problem it sounds
> like you won't have).  In the wiki we put redirect links to the new
> pages on the docs website.
>
> > I'd like to avoid Github specifically but having something else that
> > would permit to use ACO (https://acccounts.centos.org) as auth source. I
> > already played with gitea and it works with openid so self-hosted git
> > instance using ACO works fine. (but that's a different thread)
>
> /me whispers *Pagure* :P
>
> > We should divide all parts into specific areas. Benefits of using .md
> > means being able to switch to something else even later and not be tied
> > to $yet_another_tool to generate the web part. (just my idea)
>
> We are using AsciiBinder to build our docs site.  I realize this is
> $yet_another_tool, but it is one that several other projects in our
> ecosystem and sponsor system are using.  The upstream is amenable to
> patches, if needed.  It is opinionated, so you have to decide what
> you're willing to let go of and what is a "line in the sand."  One of
> those opinions, today, is the use of AsciiDoc.  I have a PoC to use
> other markups, but it is not complete.
>
> Let me know if any details on what Fedora is doing would be helpful.
> I'd like to see us work more closely on documentation, especially now
> that CentOS SIGs are often building bits that are closer to Fedora than
> to CentOS core (as I understand it).
>
> regards,
>
> bex
> _______________________________________________
> 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/20171213/2da2639d/attachment-0006.html>