#793 [spike] Discussing the future of wiki.centos.org
Closed: Insufficient Data 2 years ago by arrfab. Opened 2 years ago by arrfab.

Wiki.centos.org is currently running moin 1.9 , requiring python 2.7 and so running on CentOS 7.
We'd need to think about what to do next about it, as clearly moin upstream doesn't get traction/momentum and so no python3 version exists at this stage.

This ticket in the backlog should reflect needed spike about engaging with CentOS Community to either :

  • decommission entirely wiki.centos.org (preferred solution) and just "move" remaining up2date content to the existing mkdocs.org based workflow (adapted already for https://sigs.centos.org)
  • migrate it to a new platform (eventually mediawiki, as already used by Fedora so not "reinventing the wheel" for centos side)

I would suggest the first solution. The mediawiki on Fedora gets used mainly for change proposals and QA automation tools. After that it is people finding and trying increasingly bad amounts of past data because as Kevin says 'A wiki is Where Information Kills Itself'

I am guessing a workflow could look like:
mirror the site down as html
convert the html to markdown with pandoc
import all those md to a git repo.
put the git repo up for PR changes and forking.
use mkdocs to static generate the pages for review.
put in hooks to generate a site when merges are approved

Metadata Update from @arrfab:
- Issue tagged with: centos-common-infra

2 years ago

Metadata Update from @arrfab:
- Issue tagged with: investigation

2 years ago

I've had lots of problems with the wiki lately, so I'd like to see this happen. Alternate proposal: we have wikis built into our GitLab space, e.g. https://gitlab.com/groups/CentOS/-/wikis/home . A lot of information should go to a generated static site. But when we need a wiki for planning docs or whatever, we can just use GitLab.

I'm also not fond of having two static generators. We have jekyll for www and mkdocs for sigs. Can we consolidate?

Closing this ticket as there is now open/dedicated thread on centos-devel list.
When there will be consensus/decision we'll create ticket to reflect work to be done

Metadata Update from @arrfab:
- Issue close_status updated to: Insufficient Data
- Issue status updated to: Closed (was: Open)

2 years ago

Log in to comment on this ticket.

Metadata
Boards 1