git@vger.kernel.org mailing list mirror (one of many)
 help / color / mirror / code / Atom feed
From: Konstantin Ryabitsev <konstantin@linuxfoundation.org>
To: git@vger.kernel.org
Subject: The sad state of git.wiki.kernel.org
Date: Fri, 3 Feb 2023 13:22:55 -0500	[thread overview]
Message-ID: <20230203182255.lqla3hsme6riy4w7@meerkat.local> (raw)

Hello, all:

There is a very sad and unkempt wiki instance running on git.wiki.kernel.org.

It grew up in the age when Internet was young, bright-eyed, and "anyone can
edit it" approach was seen as a net positive thing. Then, as the armies of
bots and SEO consultants became increasingly difficult to fight off, the
instance ended up being locked down just to avoid having to spend all day
rolling back spam edits.

Today, most information found on the wiki is probably outdated and therefore
potentially harmful. I would like to solicit ideas what to do with this
resource.

# Should it be migrated to RTD-style docs?

We have stopped providing new Mediawiki instances at kernel.org quite some
time back, replacing the offering with Dokuwiki. Today, we don't spin up new
Dokuwiki instances either and everyone is steered towards readthedocs-style
documentation instead, which is a much more sane and manageable medium than
wikis, especially when it comes to technical docs (see
https://korg.docs.kernel.org/docs.html).

However, it's unclear if this is even needed for this wiki, considering the
existence of https://git-scm.com/doc.

# Should it be archived as a static site?

It's possible to turn git.wiki.kernel.org into a static site with a large
header on every page that it contains historical archival information, with a
link to https://git-scm.com/doc

# Should it be archived and put out of its misery?

The last option is to just archive the site and put it out of its increasingly
irrelevant existence.

Thoughts?

-Konstantin

             reply	other threads:[~2023-02-03 18:23 UTC|newest]

Thread overview: 10+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2023-02-03 18:22 Konstantin Ryabitsev [this message]
2023-02-03 19:43 ` The sad state of git.wiki.kernel.org Junio C Hamano
2023-02-04 11:27 ` Jeff King
2023-02-04 13:13   ` Andrei Rybak
2023-02-04 14:03   ` Christian Couder
2023-02-06 21:41     ` Konstantin Ryabitsev
2023-02-07 11:53       ` Christian Couder
2023-02-07 18:09       ` Jeff King
2023-02-09 21:31         ` Konstantin Ryabitsev
2023-02-09 21:46           ` Junio C Hamano

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: http://vger.kernel.org/majordomo-info.html

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20230203182255.lqla3hsme6riy4w7@meerkat.local \
    --to=konstantin@linuxfoundation.org \
    --cc=git@vger.kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://80x24.org/mirrors/git.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).