Re: [Tools-discuss] Please provide feedback on a proposed reworking of the datatracker /doc/html/... pages
Lars Eggert <lars@eggert.org> Sat, 24 September 2022 08:23 UTC
Return-Path: <lars@eggert.org>
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 459E3C14F742; Sat, 24 Sep 2022 01:23:13 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.213
X-Spam-Level:
X-Spam-Status: No, score=-1.213 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, HTML_MESSAGE=0.001, MIME_HTML_ONLY=0.1, MIME_HTML_ONLY_MULTI=0.001, MIME_QP_LONG_LINE=0.001, MPART_ALT_DIFF=0.79, RCVD_IN_DNSWL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-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=pass (1024-bit key) header.d=eggert.org
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 VJrPKCvH7JXo; Sat, 24 Sep 2022 01:23:08 -0700 (PDT)
Received: from mail.eggert.org (mail.eggert.org [91.190.195.94]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 739ADC14F745; Sat, 24 Sep 2022 01:23:08 -0700 (PDT)
Received: from smtpclient.apple (unknown [IPv6:2a00:ac00:4000:400:7991:ba7c:d37d:4056]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.eggert.org (Postfix) with ESMTPSA id F066B1DC3C5; Sat, 24 Sep 2022 11:22:46 +0300 (EEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=eggert.org; s=dkim; t=1664007768; bh=2aMGmaL9d6wpTwE0u+NSpSHZ4E22a6k5d4OrO4Iff9Q=; h=From:Subject:Date:References:Cc:In-Reply-To:To; b=MSAW8WcJ0brA0uomVy0SYvtQYEBu7qoN3Bf2Nwr4g6W4KNjlO4TT4fDLjy3tDz+We X+ZzVy+57SzcH1mjT+QFPvYFRkKZzdGcz7yZOu9/nynNKW9xzh24VKRsgnobjQ1oKB Wlwl33MKk+4b8SO77BJe300GRi02Q0aT/XGDqjl8=
Content-Type: multipart/alternative; boundary="Apple-Mail-2942A3CD-1B90-4869-826E-0DCECCFB803B"
Content-Transfer-Encoding: 7bit
From: Lars Eggert <lars@eggert.org>
Mime-Version: 1.0 (1.0)
Subject: Re: [Tools-discuss] Please provide feedback on a proposed reworking of the datatracker /doc/html/... pages
Date: Sat, 24 Sep 2022 11:22:35 +0300
Message-Id: <4FC08040-718C-482D-B98C-03049A82DD28@eggert.org>
References: <CALGR9obNT6GgMACVZgUC-13T2hrQ5PiDH+wFfLXG9X4x8dN2qw@mail.gmail.com>
Cc: Mark Nottingham <mnot=40mnot.net@dmarc.ietf.org>, tools-discuss <tools-discuss@ietf.org>, Working Chairs <wgchairs@ietf.org>
In-Reply-To: <CALGR9obNT6GgMACVZgUC-13T2hrQ5PiDH+wFfLXG9X4x8dN2qw@mail.gmail.com>
To: Lucas Pardue <lucaspardue.24.7@gmail.com>
X-MailScanner-ID: F066B1DC3C5.A46B5
X-MailScanner: Not scanned: please contact your Internet E-Mail Service Provider for details
X-MailScanner-From: lars@eggert.org
Archived-At: <https://mailarchive.ietf.org/arch/msg/wgchairs/exUgnSqQ8y5tQyGmL4bpWV0fAT0>
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: Sat, 24 Sep 2022 08:23:13 -0000
On Sep 24, 2022, at 07:47, Lucas Pardue <lucaspardue.24.7@gmail.com> wrote:
If we're talking styles and legibility. Can we have a dark mode capability too? I'd like this to respect the system config, browser config, or to be a preference in the datatracker.Cheers,Lucas___________________________________________________________This is wonderful and beautiful - well done!
My only feedback is that the typeface used for body text is pretty harsh for reading. Two possible ways forward:
1) Use a different typeface (still monospaced but more readable); e.g., <https://mbtype.com/fonts/triplicate/" rel="noreferrer nofollow" target="_blank">https://mbtype.com/fonts/triplicate/>
2) Try to detect artwork / code blocks and only use monospaced for them (I know this is likely challenging and maybe controversial).
Tweaking line heights might also help; those lines are pretty long to be so squashed together, I suspect.
Cheers,
> On 23 Sep 2022, at 5:53 am, Robert Sparks <rjsparks@nostrum.com> wrote:
>
> We've set up https://sandbox-htmlize.ietf.org/" rel="noreferrer nofollow" target="_blank">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" rel="noreferrer nofollow" target="_blank">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" rel="noreferrer nofollow" target="_blank">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" rel="noreferrer nofollow" target="_blank">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" rel="noreferrer nofollow" target="_blank">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
>
--
Mark Nottingham https://www.mnot.net/" rel="noreferrer nofollow" target="_blank">https://www.mnot.net/
Tools-discuss mailing list - Tools-discuss@ietf.org - https://www.ietf.org/mailman/listinfo/tools-discuss
- Please provide feedback on a proposed reworking o… Robert Sparks
- Re: Please provide feedback on a proposed reworki… David Schinazi
- Re: Please provide feedback on a proposed reworki… Ian Swett
- Re: Please provide feedback on a proposed reworki… Timothy Mcsweeney
- Re: Please provide feedback on a proposed reworki… Lucas Pardue
- Re: Please provide feedback on a proposed reworki… Tim Wicinski
- Re: Please provide feedback on a proposed reworki… Robert Sparks
- Re: Please provide feedback on a proposed reworki… Tim Wicinski
- Re: [Tools-discuss] Please provide feedback on a … John C Klensin
- Re: Please provide feedback on a proposed reworki… Lars Eggert
- Re: Please provide feedback on a proposed reworki… Mirja Kuehlewind
- Re: Please provide feedback on a proposed reworki… Mark Nottingham
- Re: Please provide feedback on a proposed reworki… Lucas Pardue
- Re: [Tools-discuss] Please provide feedback on a … Lars Eggert