Please provide feedback on a proposed reworking of the datatracker /doc/html/... pages

Robert Sparks <rjsparks@nostrum.com> Thu, 22 September 2022 19:54 UTC

Return-Path: <rjsparks@nostrum.com>
X-Original-To: wgchairs@ietfa.amsl.com
Delivered-To: wgchairs@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id CCBCAC14F74A; Thu, 22 Sep 2022 12:54:08 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.686
X-Spam-Level:
X-Spam-Status: No, score=-1.686 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_INVALID=0.1, DKIM_SIGNED=0.1, RCVD_IN_DNSWL_BLOCKED=0.001, T_SCC_BODY_TEXT_LINE=-0.01, T_SPF_HELO_PERMERROR=0.01, T_SPF_PERMERROR=0.01, URIBL_BLOCKED=0.001, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=no autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=fail (1024-bit key) reason="fail (message has been altered)" header.d=nostrum.com
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 72dEOPEev7dx; Thu, 22 Sep 2022 12:54:04 -0700 (PDT)
Received: from nostrum.com (raven-v6.nostrum.com [IPv6:2001:470:d:1130::1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 21369C159A1D; Thu, 22 Sep 2022 12:54:02 -0700 (PDT)
Received: from [192.168.1.102] ([47.186.48.51]) (authenticated bits=0) by nostrum.com (8.17.1/8.17.1) with ESMTPSA id 28MJs0q6066204 (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384 bits=256 verify=NO); Thu, 22 Sep 2022 14:54:00 -0500 (CDT) (envelope-from rjsparks@nostrum.com)
DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=nostrum.com; s=default; t=1663876441; bh=5CikwvAWm7gPmfcNRU9iGvsQTFC7+T9yHyLQQ9E3//M=; h=Date:To:Reply-To:From:Subject; b=h965yGYFlSIs8RmbKCMFC9Bjh03DvaPrsu+DO8aZhEUgRQhRJHDWCpRK7oSsvSIbX DQSt4ra+2fezQOgi7yg8s7rsiN40R8XA4CqHuXAS03AtKYLZBvbYwgooInK5LfsyJ+ F+rLMc92BDOu6TEcIIRra7phyXjYW1EASRq8Qevo=
X-Authentication-Warning: raven.nostrum.com: Host [47.186.48.51] claimed to be [192.168.1.102]
Message-ID: <9085c285-1499-77c2-21a6-0f615286f31e@nostrum.com>
Date: Thu, 22 Sep 2022 14:53:54 -0500
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.15; rv:91.0) Gecko/20100101 Thunderbird/91.13.0
Content-Language: en-US
To: tools-discuss <tools-discuss@ietf.org>, ietf@ietf.org, Working Chairs <wgchairs@ietf.org>
Reply-To: tools-discuss <tools-discuss@ietf.org>
From: Robert Sparks <rjsparks@nostrum.com>
Subject: Please provide feedback on a proposed reworking of the datatracker /doc/html/... pages
Content-Type: text/plain; charset="UTF-8"; format="flowed"
Content-Transfer-Encoding: 7bit
Archived-At: <https://mailarchive.ietf.org/arch/msg/wgchairs/bBuUWBv_rZFu1AT2_QoMFRgTXM8>
X-BeenThere: wgchairs@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: Working Group Chairs <wgchairs.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/wgchairs>, <mailto:wgchairs-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/wgchairs/>
List-Post: <mailto:wgchairs@ietf.org>
List-Help: <mailto:wgchairs-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/wgchairs>, <mailto:wgchairs-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 22 Sep 2022 19:54:08 -0000

We've set up https://sandbox-htmlize.ietf.org/ to help continue to get 
feedback on the htmlization changes a group led by Lars has been working 
towards.

These changes will replace/enhance how pages at /doc/html/... are built.

First - Many thanks to the tools-discuss participants who helped verify 
this temporary site's configuration, and have started providing feedback 
already on this thread: 
https://mailarchive.ietf.org/arch/browse/tools-discuss/?q=help%20check%20config

Compare, for example:

https://datatracker.ietf.org/doc/html/draft-ietf-v6ops-ipv6-deployment-07

and

https://sandbox-htmlize.ietf.org/doc/html/draft-ietf-v6ops-ipv6-deployment-07

Please try the new site at

Report issues and provide feedback either at tools-discuss@ietf.org or 
at the github datatracker repository. Please be clear in the feedback 
that you are talking about what's being served at sandbox-htmlize and 
not the production datatracker.

If you spot something and want to contribute code, be sure your PR 
targets the feat/htmlize branch at 
https://github.com/ietf-tools/datatracker/tree/feat/htmlize.

We plan to leave this running to collect feedback only for a short time, 
so please take a look and provide feedback as soon as you can.

RjS