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

Lucas Pardue <lucaspardue.24.7@gmail.com> Thu, 22 September 2022 20:45 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 1825EC14CE28; Thu, 22 Sep 2022 13:45:39 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -6.855
X-Spam-Level:
X-Spam-Status: No, score=-6.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_HI=-5, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, 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 bxeZfY5f1RqI; Thu, 22 Sep 2022 13:45:35 -0700 (PDT)
Received: from mail-oi1-x22f.google.com (mail-oi1-x22f.google.com [IPv6:2607:f8b0:4864:20::22f]) (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 58635C14F743; Thu, 22 Sep 2022 13:45:35 -0700 (PDT)
Received: by mail-oi1-x22f.google.com with SMTP id o64so13879124oib.12; Thu, 22 Sep 2022 13:45:35 -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=KcOhiCJTTQVtirViVBdifi9OE30VgGO+noqaV0N1cNA=; b=PkoogVRec6wctQnKPeCWPbcZHGsYYIAY9k1MOeeppO7OdeSplEm7xTFRNaTZxOSOoT B6sXrXJRvyNSEPx5BH0EbfRkBVDZSJ/Wsc75kTm8i4xniC5N7vQshohq39OVKNV77pGj lePOe/jFVPqZAx952/o4DACcAWGbzJRXhle/6r2MDLGigB5ar2ajx9ZJTyQbn3sHuJLE yxmwSjnX+63PjAvQ9BR/gBeiyL2qJCd/OJ04scfyCr4s7gec5M5ieRQ2jaW0DE1H7Lmx f22wjDj64pTcsnmBuSzBKTA8hQG2M6T6H8WkTnGlPhCtSZHMTVZSW9nwK0mZeiQAgA09 /pqA==
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=KcOhiCJTTQVtirViVBdifi9OE30VgGO+noqaV0N1cNA=; b=ASyi9ESdTGkMgI/0ALiJ6zlDZNCVRTIRUjyZArjB7GZqBkZ1uu+7l6BCzdwgSLcUBY vUxKh1hBgKPHRw3wjBCRcgJVSw73GsbrKa6brfPLSCGXY0C8v/VC+Y5g1ZdUcfLJUGbf 5gLlKPoxYfiTG8y42BFifNbHQWN0fzz2Zzp0zewn5O+vWeD+bBC9VOXy8d4k9FLwER7f u/xTAbCKzUc6clv3cb1qCDBd5HQ6ejqzXXOForG2YM3CVkbFzcqkXWwetDEJ6JdmCj+T W6mD5Eg75TwIIZBVFqL9gE26tZqXbFzm19sg0SVTP3bQktUpQ4LMlazTQMRMK7Upt9Si Qung==
X-Gm-Message-State: ACrzQf0Fd5NP3kGYrX8L5/i6021sqWjTv92GcT39BneFoxYtO/leg1sM FFLK2a9EZTd6I18qk811LoLgAbWstARYZJ/Q60k=
X-Google-Smtp-Source: AMsMyM4nAt06FLIGYx1HUt4GdxK7WZYsJvFABwYFt02m6+/A0vGXpyEPzPXoGeFGMMXmgNnkHXxtsUb0uH4NicWLkok=
X-Received: by 2002:a05:6808:14cf:b0:350:b76b:cf9a with SMTP id f15-20020a05680814cf00b00350b76bcf9amr2411756oiw.249.1663879534608; Thu, 22 Sep 2022 13:45:34 -0700 (PDT)
MIME-Version: 1.0
References: <9085c285-1499-77c2-21a6-0f615286f31e@nostrum.com> <195717231.215129.1663877635971@email.ionos.com>
In-Reply-To: <195717231.215129.1663877635971@email.ionos.com>
From: Lucas Pardue <lucaspardue.24.7@gmail.com>
Date: Thu, 22 Sep 2022 21:45:23 +0100
Message-ID: <CALGR9oZX2So+Rpbs66rXiDahNwFVNFFxcsY5sQNRodXNDgSYNw@mail.gmail.com>
Subject: Re: Please provide feedback on a proposed reworking of the datatracker /doc/html/... pages
To: Timothy Mcsweeney <tim@dropnumber.com>
Cc: tools-discuss <tools-discuss@ietf.org>, Robert Sparks <rjsparks@nostrum.com>, ietf@ietf.org, Working Chairs <wgchairs@ietf.org>
Content-Type: multipart/alternative; boundary="0000000000009c04f805e94a2450"
Archived-At: <https://mailarchive.ietf.org/arch/msg/wgchairs/8V_b8nNqE6Jr_k6b2ZEbMRiVNs4>
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 20:45:39 -0000

This is a very nice improvement. Thanks to those involved.

1) Is the "Contents" tab supposed to show something? It renders as blank on
my Windows PC in both Firefox 104 and Chrome 105.

2) On desktop, I like that when my viewport is narrow it puts the I-D name
on the top. That makes it easier to keep track when tab hopping multiple
documents. Did you consider putting the I-D name in panel itself?

However, on mobile, that top bar might be an annoying use of valuable
space. Maybe you could right justify the text and drop the "Internet-Draft"
rounded rectangle thing to save a little space and make it more of a
hovering element?

3) On desktop, when the view is narrow, the burger menu presents both
vertical and horizontal scrollbars that don't do anything.

4) On mobile and desktop, the burger menu doesn't contain any tabs for
"Content" or "Prefs".

Cheers,
Lucas

On Thu, Sep 22, 2022 at 9:14 PM Timothy Mcsweeney <tim@dropnumber.com>
wrote:

> It would be cool if in the Prefs tab I could switch the side bar to the
> bottom or the other side.
>
>
>
>
> > On 09/22/2022 3:53 PM EDT 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
>
>