Re: [Tools-discuss] Gathering requirements for a new wiki

Jay Daley <jay@ietf.org> Thu, 08 April 2021 22:25 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 [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id B74FA3A1F5E for <tools-discuss@ietfa.amsl.com>; Thu, 8 Apr 2021 15:25:15 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.898
X-Spam-Level:
X-Spam-Status: No, score=-1.898 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HTML_MESSAGE=0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
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 bIpqWW1b7pqd for <tools-discuss@ietfa.amsl.com>; Thu, 8 Apr 2021 15:25:10 -0700 (PDT)
Received: from jays-mbp.localdomain (unknown [158.140.230.105]) (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 A10FD3A1F5B for <tools-discuss@ietf.org>; Thu, 8 Apr 2021 15:25:09 -0700 (PDT)
From: Jay Daley <jay@ietf.org>
Content-Type: multipart/alternative; boundary="Apple-Mail=_92AE33E3-EA19-47C0-8885-C48EE9691B58"
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.120.23.2.4\))
Date: Fri, 9 Apr 2021 10:25:06 +1200
References: <DAFC09C5-730C-4967-BF2F-9C0991AD1151@ietf.org>
To: Tools Discussion <tools-discuss@ietf.org>
In-Reply-To: <DAFC09C5-730C-4967-BF2F-9C0991AD1151@ietf.org>
Message-Id: <A045780A-1BAC-45B7-B9D5-0024C248F579@ietf.org>
X-Mailer: Apple Mail (2.3608.120.23.2.4)
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/0E4JgEu5zh0iW8GjDMtZefMF7rQ>
Subject: Re: [Tools-discuss] Gathering requirements for a new wiki
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: Thu, 08 Apr 2021 22:25:16 -0000

Just a reminder about this before we move to assess and recommend a new wiki platform based on the proposed features below.

Jay

> On 31/03/2021, at 2:06 PM, Jay Daley <jay@ietf.org> wrote:
> 
> I’m helping out the Tools Team PM (Robert) with the migration of functionality from tools.ietf.org and one area that needs addressing is wikis.  We currently use Trac to provide wikis though Trac itself has a broader applicability for software project management.  The Secretariat maintains a Trac installation at https://trac.ietf.org with separate instances for each current Working Group (WG), Directorate, Team, and most concluded WGs.  Some of the wiki instances only point to other resources, others are reasonably detailed, while the majority appear to be unused or broken (cannot be started). 
> 
> The full usage stats are:
> 
> 	• Total			364
> 	• Unused			157
> 	• Broken			28
> 	• In use - wiki		140
> 	• In use - issues	39
> 
> 
> We are proposing to replace Trac with a new wiki product and instead of having multiple public instances, have a single community wiki, with the existing pages copied over.  This will be a true community wiki with any member of the community able to add/change pages and reorganise as needed, moderated by other members of the community and the secretariat, and provided they have a datatracker login to authenticate with.  Private pages will be allowed, but their creation controlled by the admins.
> 
> In multiple small discussions with the community, the following requirements have emerged for new wiki software:
> 
> • Strategic
> 
> 	• Must be available at reasonable cost (to the IETF LLC) for possibly thousands of users.
> 
> 	• Must be widely used, well documented, actively developed and actively supported to ensure that we do not end up with a dead-end product.  This includes any required plugins.
> 
> 	• Must be a specific wiki product and not a larger product that includes a wiki as one part of its functionality, to prevent complications and overlaps with other tools.
> 
> 	• Must be scalable to support tens of thousands of users to support the full IETF community and reasonable future growth.
> 
> • Content
> 
> 	• Must support a text based input language.
> 
> 	• Must support code snippets, maths expressions and diagrams to enable the full representation of the same kind of content as found in I-Ds and RFCs.
> 
> 	• Must provide an excellent mobile experience.
> 
> 	• Must provide content backup, change visibility, and the ability to revert changes
> 
> 	• Should support Markdown by default for page content.
> 
> 	• Should support git for content backup and change visibility.
> 
> 	• Should provide a WYSIWYG editor for Markdown that can be used interchangeably with direct Markdown editing.
> 
> 	• Should have a themable interface to enable the wiki to be given a look and feel consistent with www.ietf.org.
> 
> • Integration
> 
> 	• Must support OIDC for authentication and role permissions.
> 
> 	• Must support custom module development.
> 
> 	• Should support Matomo for web analytics so that these can be integrated with our website statistics.
> 
> • Local management (if self-hosted)
> 
> 	• Must support either MySql/MariaDB or PostgreSQL as those are the database products supported by the IT operations team.
> 
> 	• Must run on Linux and should run in a Docker container to fit with the management processes of the IT operations team.
> 
> 
> We would like your views on these requirements so that we can move to assessing products.
> 
> 
> thanks
> Jay
> 
> -- 
> Jay Daley
> IETF Executive Director
> jay@ietf.org
> 
> ___________________________________________________________
> Tools-discuss mailing list - Tools-discuss@ietf.org
> This list is for discussion, not for action requests or bug reports.
> * Report datatracker and mailarchive bugs to: datatracker-project@ietf.org
> * Report tools.ietf.org bugs to: webmaster@tools.ietf.org
> * Report all other bugs or issues to: ietf-action@ietf.org
> List info (including how to Unsubscribe): https://www.ietf.org/mailman/listinfo/tools-discuss

-- 
Jay Daley
IETF Executive Director
jay@ietf.org