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

Lucas Pardue <lucaspardue.24.7@gmail.com> Sat, 24 September 2022 04:46 UTC

Return-Path: <lucaspardue.24.7@gmail.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 7C878C14CF0B; Fri, 23 Sep 2022 21:46:21 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.855
X-Spam-Level:
X-Spam-Status: No, score=-1.855 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, FREEMAIL_ENVFROM_END_DIGIT=0.25, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.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 xcoaSmO-XH1W; Fri, 23 Sep 2022 21:46:17 -0700 (PDT)
Received: from mail-ot1-x332.google.com (mail-ot1-x332.google.com [IPv6:2607:f8b0:4864:20::332]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 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 5646FC14F747; Fri, 23 Sep 2022 21:46:17 -0700 (PDT)
Received: by mail-ot1-x332.google.com with SMTP id h9-20020a9d5549000000b0063727299bb4so1219977oti.9; Fri, 23 Sep 2022 21:46:17 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date; bh=4wOMPZ15N/z6j1s8hinjlh5fYSZm/8QdR8+MLc/WOUU=; b=AXw6rF2ynTEULQ2EKDtwtI7lXozEWjGb1Gn2cCPGMAnFbWT47bo/bhHQ3MA1ZvJvRR MIxJZzCJn+NKbu4wna8z9fZlL8RI0QgKy27l19lOa4PSgxAl4pVsA0hQMEjAnhtEHWNT eVc0rlAs2Lgl7y4iRAdjwS9Br47X4vX2+3T5CbUaTayLUZL/12i7cTGaQJg9dSPIgdxt VvvCFeMGsoKjboY/QZIRDfjOhN4rjSbr1CFyjU+uSfCoN9gB+tQM1ZvmOzMKjKqBLC3W bVSvBTlEJScpC6OI7ZEp9yzdOR8QeitKQ0SPA00A7Ds9Ilvf9JFuR0l93qjSHD2q2X/t tBPw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date; bh=4wOMPZ15N/z6j1s8hinjlh5fYSZm/8QdR8+MLc/WOUU=; b=Guanr3js+lutRXifYuS6NEcYS6uqeO8b/s3MrRxfBwSHOQCg5djRFRaBzkoa4X8hjU dE663EnTUI88qHnD9KQY/WM28kMKukOk+aieiUziXlqAFBiSko+9uTF5J5AGKq8afWqe dwLh69eIGMvARrEMHQ8WyEyl2qf+D5M6Q1J3ljG/JfeklpzZaWSt9lwWFZnhW50s5Elj RJcvLhTdFFjLhu/v0k9IomLPtccLr2n4UjfbURTetZnPqefAryqBVdaGRoKqfVwK7bWM 0y31T8Je9eKv3PPArpCUEKBPeNammsBldba695AoruGzdwM8kY2hdK1YFvxMgrrebsZB u8fw==
X-Gm-Message-State: ACrzQf2wmMlLS+YlUH61z/KKR3vPU8twK8NLlnaCMdi9q/XtBhU+LAS5 +t93UMcNTxSSsmfCYM2fyubQAQoS84meZ9vwHQEdrtC5
X-Google-Smtp-Source: AMsMyM5DcBwMMw4w2QxTqEcR6Ld71TdWHHGMAzIpMx0+QvREXvkf0T5TSNwx42FeytfUjhGfBUez1I8JH8qvMrFBSWM=
X-Received: by 2002:a05:6830:165a:b0:654:edd:d5c with SMTP id h26-20020a056830165a00b006540edd0d5cmr5399115otr.280.1663994776289; Fri, 23 Sep 2022 21:46:16 -0700 (PDT)
MIME-Version: 1.0
References: <9085c285-1499-77c2-21a6-0f615286f31e@nostrum.com> <35305598-6257-4421-A4EC-AB68B40129A0@mnot.net>
In-Reply-To: <35305598-6257-4421-A4EC-AB68B40129A0@mnot.net>
From: Lucas Pardue <lucaspardue.24.7@gmail.com>
Date: Sat, 24 Sep 2022 05:46:05 +0100
Message-ID: <CALGR9obNT6GgMACVZgUC-13T2hrQ5PiDH+wFfLXG9X4x8dN2qw@mail.gmail.com>
Subject: Re: Please provide feedback on a proposed reworking of the datatracker /doc/html/... pages
To: Mark Nottingham <mnot=40mnot.net@dmarc.ietf.org>
Cc: tools-discuss <tools-discuss@ietf.org>, Working Chairs <wgchairs@ietf.org>
Content-Type: multipart/alternative; boundary="0000000000008c864a05e964f95a"
Archived-At: <https://mailarchive.ietf.org/arch/msg/wgchairs/ZZoLaLovRffP8JuyxxoRBWY1zKM>
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 04:46:21 -0000

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/>
>
> 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/ 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
> >
>
> --
> Mark Nottingham   https://www.mnot.net/
>
>