CentOS docs - Aug 2022 - [CentOS-devel] What to do with wiki.centos.org ? (let's discuss it)

On Tue, Aug 30, 2022 at 12:42 AM Fabian Arrotin <arrfab at centos.org>
wrote:
>
> On 25/08/2022 17:10, Trevor Hemsley via CentOS-devel wrote:
> > On 25/08/2022 15:28, Robby Callicotte via CentOS-devel wrote:
> >> On Thursday, August 25, 2022 8:46:18 AM CDT Neal Gompa wrote:
> >>> I second this. Our quick docs could use MkDocs like the SIG
stuff
> >>> does, and the RHELish stuff can use the Antora system the RHEL
docs
> >>> folks want to use.
> >> I agree with Neal here.  This seems to offer a good balance.  At
this
> >> point I
> >> would argue that the MR/PR nature of git is ubiquitous and is part
of
> >> everyone's workflow.
> >
> > So far I've seen lots of "yes, use this" type comments
so I'd like to
> > ask how this compares in user friendliness to the current wiki
(assuming
> > that you can get to it because the spammers are taking a rest).
I've
> > never used any of the alternatives that have been proposed so far. Are
> > they wikis? Are they usable for a non-technical user? The wiki, you
> > press a button and you can edit content directly and see what it will
> > look like before you save it. You can link to other pages easily, you
> > can format content how you want it easily, often just at the press of
a
> > button.
> >
> > None of what I've heard so far sounds even remotely as usable as
what we
> > have now.
> >
> > Trevor
>
> It seems I opened a "Pandora's box" last week before the
weekend ... :-)
>
> To keep a long story short, I just wanted to announce that something
> needs to be done, and also explaining publicly why wiki is misbehaving
> on regular basis (so that people don't have wrong expectations about
> wiki online service)
>
> what I see so far for wiki.centos.org :
> - nothing is done and so it will just be deleted when centos 7 goes EOL
> in June 2024 (no, we'll not even consider having a c7 online past that
> EOL date)
> - centos-docs team is having a look at migrating content to another wiki
> (the sooner the better then), like mediawiki or else
> - or just consider moving to "static" sites (decision is up to
people
> contributing content)
>
> FWIW, actually it's possible to edit/contribute to SIG guide *without*
> having to learn the git workflow (like PR/MR, fork, commit, push,
> rebase, etc).
>
> There is an "Edit this page" button/link on each page under
> https://sigs.centos.org/guide/ and it's just log you directly on
> git.centos.org (with SSO) to edit directly the page (if you have commit
> rights). It works also with github/gitlab
>
> PS : we don't have to migrate it next week (even if I'd like to see
> current setup moved/migrated to something else soon) but just keeping in
> mind some EOL dates approaching and not waiting for last minute
> discussion ;-)
>
> --
> Fabian Arrotin
> The CentOS Project | https://www.centos.org
> gpg key: 17F3B7A1 | twitter: @arrfab
Let's keep the centos-docs in the loop.

Akemi