[Tools-discuss] Recommended new wiki product

Jay Daley <jay@ietf.org> Tue, 13 April 2021 21:42 UTC

Return-Path: <jay@ietf.org>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost []) by ietfa.amsl.com (Postfix) with ESMTP id 2E1CE3A10F6 for <tools-discuss@ietfa.amsl.com>; Tue, 13 Apr 2021 14:42:02 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Received: from mail.ietf.org ([]) by localhost (ietfa.amsl.com []) (amavisd-new, port 10024) with ESMTP id 4relFx8JvA1Q for <tools-discuss@ietfa.amsl.com>; Tue, 13 Apr 2021 14:42:00 -0700 (PDT)
Received: from jays-mbp.localdomain (unknown []) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPSA id 6378B3A10F5 for <tools-discuss@ietf.org>; Tue, 13 Apr 2021 14:42:00 -0700 (PDT)
From: Jay Daley <jay@ietf.org>
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.\))
Message-Id: <AF31CC37-95B6-4C1F-8C4A-EA6EB228EDB9@ietf.org>
Date: Wed, 14 Apr 2021 09:41:56 +1200
To: Tools Discussion <tools-discuss@ietf.org>
X-Mailer: Apple Mail (2.3608.
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/eGihlMqjx9yKQqWhqnn4DtgKaSg>
Subject: [Tools-discuss] Recommended new wiki product
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss/>
List-Post: <mailto:tools-discuss@ietf.org>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 13 Apr 2021 21:42:02 -0000

Hi All

The requirements for a new wiki have been consulted on [1] and it has been confirmed on today’s call that there are no further changes.  Based on that we can now move to a recommendation for a new wiki product.

There are over a hundred wiki products available and an exhaustive requirements assessment has not been conducted.  Based on the agreed requirements, the following products have been evaluated and rejected:

	• MediaWiki
		• Markdown only supported by an unmaintained extension
		• Limited interface customization
		• Limited WYSIWYG editor
	• Confluence
		• Too costly.  It might be possible to get a free license but no guarantee that would always be available.
	• Dokuwiki
		• Uses the file system and not a database.
		• Markdown by default is experimental feature
	• TWiki
		• Will not support Markdown
		• Much more than just a wiki
	• Trac
		• Much more than a wiki product
		• Markdown plugin is unmaintained
		• Significant community hostility

The proposed product, that meets all the agreed requirements and meets them well is:

	• Wiki.js
		• Core Markdown with optional WYSIWYG
		• Core OIDC support
		• Very actively developed and supported with excellent documentation
		• Designed for containers
		• Core support for code snippets, maths expressions and diagrams
		• Core support for Git
		• Supports Matomo
		• Themes are weak in comparison to other products requiring a developer familiar with the NodeJS vue framework.
		• Runs on multiple databases including MySQL and PostgreSQL though may move to solely support PostgreSQL in the future.

Please let me know if you think there is a mistake in the assessment or there is another product that meets the requirements [1] better.


[1]  https://mailarchive.ietf.org/arch/msg/tools-discuss/OKPzIqdz79FAdrKcx9SNDGysUww/

Jay Daley
IETF Executive Director