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

Jay Daley <jay@ietf.org> Mon, 12 April 2021 21:31 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 C27E73A0E79 for <tools-discuss@ietfa.amsl.com>; Mon, 12 Apr 2021 14:31:47 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.298
X-Spam-Level:
X-Spam-Status: No, score=-1.298 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HTML_MESSAGE=0.001, HTTPS_HTTP_MISMATCH=0.1, URIBL_BLOCKED=0.001, URI_NOVOWEL=0.5] autolearn=no 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 e332PbKuGZyQ; Mon, 12 Apr 2021 14:31:43 -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 26C0B3A0E6B; Mon, 12 Apr 2021 14:31:41 -0700 (PDT)
From: Jay Daley <jay@ietf.org>
Message-Id: <E9248C24-9194-4736-BCB6-0889E2EBADF2@ietf.org>
Content-Type: multipart/alternative; boundary="Apple-Mail=_387BA6A0-BF76-41B8-B4DD-55817FA6DC3D"
Mime-Version: 1.0 (Mac OS X Mail 13.4 \(3608.120.23.2.4\))
Date: Tue, 13 Apr 2021 09:31:37 +1200
In-Reply-To: <DM6PR02MB692481B469F5523AA7ED1512C3739@DM6PR02MB6924.namprd02.prod.outlook.com>
Cc: Tools Discussion <tools-discuss@ietf.org>
To: "STARK, BARBARA H" <bs7652@att.com>
References: <DAFC09C5-730C-4967-BF2F-9C0991AD1151@ietf.org> <A045780A-1BAC-45B7-B9D5-0024C248F579@ietf.org> <DM6PR02MB692481B469F5523AA7ED1512C3739@DM6PR02MB6924.namprd02.prod.outlook.com>
X-Mailer: Apple Mail (2.3608.120.23.2.4)
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/XGW_-4AGCZ_PXs9HUGfUtS9C1NY>
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: Mon, 12 Apr 2021 21:31:48 -0000


> On 10/04/2021, at 12:48 AM, STARK, BARBARA H <bs7652@att.com> wrote:
> 
> Thx Jay. One additional requirement occurred to me. It’s one I’ve seen supported on all the platforms I’m familiar with, but it’s probably best not to assume...
> Support for file attachments (via upload) on wiki pages

I will ensure that is included.

Jay

>  
> Barbara
>  
> 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 <mailto:jay@ietf.org>> wrote:
>  
> I’m helping out the Tools Team PM (Robert) with the migration of functionality from tools.ietf.org <https://urldefense.com/v3/__http:/tools.ietf.org__;!!BhdT!wNiWdlhm35XJVFSpBip00DgvnFLuOD2hmSN_FHgMqQB_i7UMV6WX3cQf8qj_qA$> 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 <https://urldefense.com/v3/__https:/trac.ietf.org__;!!BhdT!wNiWdlhm35XJVFSpBip00DgvnFLuOD2hmSN_FHgMqQB_i7UMV6WX3cSc4rxBfg$> 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 <https://urldefense.com/v3/__http:/www.ietf.org__;!!BhdT!wNiWdlhm35XJVFSpBip00DgvnFLuOD2hmSN_FHgMqQB_i7UMV6WX3cSixktpMQ$>.
> 
> • 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 <mailto:jay@ietf.org>
> 
> ___________________________________________________________
> Tools-discuss mailing list - Tools-discuss@ietf.org <mailto: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 <mailto:datatracker-project@ietf.org>
> * Report tools.ietf.org bugs to: webmaster@tools.ietf.org <mailto:webmaster@tools.ietf.org>
> * Report all other bugs or issues to: ietf-action@ietf.org <mailto:ietf-action@ietf.org>
> List info (including how to Unsubscribe): https://www.ietf.org/mailman/listinfo/tools-discuss <https://urldefense.com/v3/__https:/www.ietf.org/mailman/listinfo/tools-discuss__;!!BhdT!wNiWdlhm35XJVFSpBip00DgvnFLuOD2hmSN_FHgMqQB_i7UMV6WX3cRoTvDkCA$>
>  
> -- 
> Jay Daley
> IETF Executive Director
> jay@ietf.org <mailto:jay@ietf.org>
-- 
Jay Daley
IETF Executive Director
jay@ietf.org