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

Dark mode will come with https://github.com/twbs/bootstrap/pull/35857" rel="nofollow">https://github.com/twbs/bootstrap/pull/35857 for the entire datatracker.

Fonts used are basically the default bootstrap fonts, modulo any local font configuration in the browser. There is an ongoing discussion about what we should do in terms of fonts; hopefully the UI/UX contractor will inform this.

Regarding font sizes, I’m thinking about adding a pref stetting to cap the max font size.

-- 
Sent from a mobile device; please excuse typos.

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

On Sat, Sep 24, 2022 at 4:39 AM Mark Nottingham <mnot=40mnot.net@dmarc.ietf.org> wrote:
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