Re: [Tools-discuss] Recommended new wiki product

Tom Pusateri <pusateri@bangj.com> Tue, 20 April 2021 20:59 UTC

Return-Path: <pusateri@bangj.com>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 83B1A3A1A70; Tue, 20 Apr 2021 13:59:42 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.099
X-Spam-Level:
X-Spam-Status: No, score=-2.099 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_BLOCKED=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=bangj.com
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 9xRwYhTHo_Rs; Tue, 20 Apr 2021 13:59:37 -0700 (PDT)
Received: from oj.bangj.com (69-77-154-174.static.skybest.com [69.77.154.174]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 43F083A1A81; Tue, 20 Apr 2021 13:59:36 -0700 (PDT)
Received: from [172.16.10.196] (mta-107-13-246-59.nc.rr.com [107.13.246.59]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by oj.bangj.com (Postfix) with ESMTPSA id C07B3122C3; Tue, 20 Apr 2021 16:59:34 -0400 (EDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=bangj.com; s=201907; t=1618952374; bh=5GWkB9XMYfdE+yWcGlUzzsKSw4ur1Ij0LbnSu2SPcMg=; h=Subject:From:In-Reply-To:Date:Cc:References:To:From; b=s49sPDJo4lVRgWNr+DYJXkXkBK0a0s30Z+g3JAXgcDrflN1Ib0da6VmITyiiqgjcD qvNGP1xqzMWnJw3GquZRtMObaM8DTeYxXZ7KtWvyDU4Uf35G4VJ0fCdyWbGYvUJe2P Az3EOz3sWxCgcNapep8EvMmFqcMm1SZ8prC7GcrFrrlOBgAs/xl+E8DdZSRpgztBdr tbNvikIq7Z8blBrOPR3H+aXiltZLinijyNQy1ZqWefZGmJa/RwYTm9RmcZHh8+zd2+ 7XTXMmMzGMpZiyCto1zb8xXe7Bc/Us/3fuGb5a7VpXUBqWPa2Hrpkt7bAv1p1sOiJK XCX9rIrVxhhZA==
Content-Type: text/plain; charset=utf-8
Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.60.0.2.21\))
From: Tom Pusateri <pusateri@bangj.com>
In-Reply-To: <AF31CC37-95B6-4C1F-8C4A-EA6EB228EDB9@ietf.org>
Date: Tue, 20 Apr 2021 16:59:34 -0400
Cc: Tools Discussion <tools-discuss@ietf.org>
Content-Transfer-Encoding: quoted-printable
Message-Id: <7A473CB2-F49E-465C-834B-E29C9565FB2C@bangj.com>
References: <AF31CC37-95B6-4C1F-8C4A-EA6EB228EDB9@ietf.org>
To: Jay Daley <jay@ietf.org>
X-Mailer: Apple Mail (2.3654.60.0.2.21)
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/HQjThiVNsdbHOjCdApTbGdZSPW4>
Subject: Re: [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, 20 Apr 2021 20:59:43 -0000

> On Apr 13, 2021, at 5:41 PM, Jay Daley <jay@ietf.org> wrote:
> 
> 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.
> 
> thanks
> Jay

Wiki.js looks like a nice product. The main problem I’ve had with products like this in the past is getting data out of them when you switch because you want to replace it or the project has been abandoned.

This product uses PostgreSQL in the long term and while the data will be there, it will likely require some custom programming to get it out for a migration.

My preference has been to use tools that store their data in flat files to reduce migration problems but as long as we understand this going in and are prepared to do what is needed to migrate the data or abandon it, I’m ok with it because I realize we can’t have all the features we want.

Tom