Re: [Tools-discuss] mangled ToC in RFC 8784

Bob Hinden <bob.hinden@gmail.com> Thu, 29 October 2020 00:16 UTC

Return-Path: <bob.hinden@gmail.com>
X-Original-To: tools-discuss@ietfa.amsl.com
Delivered-To: tools-discuss@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id EA77D3A0140 for <tools-discuss@ietfa.amsl.com>; Wed, 28 Oct 2020 17:16:59 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.098
X-Spam-Level:
X-Spam-Status: No, score=-2.098 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_FROM=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=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 ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 1jgR6jqFPVGV for <tools-discuss@ietfa.amsl.com>; Wed, 28 Oct 2020 17:16:58 -0700 (PDT)
Received: from mail-wr1-x434.google.com (mail-wr1-x434.google.com [IPv6:2a00:1450:4864:20::434]) (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 34CD23A0B8C for <tools-discuss@ietf.org>; Wed, 28 Oct 2020 17:16:11 -0700 (PDT)
Received: by mail-wr1-x434.google.com with SMTP id x7so930650wrl.3 for <tools-discuss@ietf.org>; Wed, 28 Oct 2020 17:16:11 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:message-id:mime-version:subject:date:in-reply-to:cc:to :references; bh=CYVTE6RzE4gcicUTctNbG9uDKMzjUKts0ZHrEKxsoF4=; b=suJoc0yMxGLoJk6PlG1cSIu4B14NOLnGWFkqSBm8m446AP1VLhLf3zd1UAByveN0V8 mJNoFXxFdOmQyQm15+IGuvvlGAkcGPqzLXGaX3EPo43inB1aG9Av6W4oVpvJFsNbQ11J Xmu3RsNusK4vA2m2nE7CYFiQ2YXi6bM/rM9P9UUgClZkcmuDM1s+qKtfzWsWHflfmjA0 zJb6lhKkqLJldt5eai7hIcAQe7Jg5FK96Hhh+lKvYJoGEhJJ+ZZuvM8XQWviiU983dCy gak0rr9ARj1i2vdhiBgDWklysxslE185bJjbzJOwfCXepN8Uba9VkdghWpLXl8McLk2n /o6Q==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:message-id:mime-version:subject:date :in-reply-to:cc:to:references; bh=CYVTE6RzE4gcicUTctNbG9uDKMzjUKts0ZHrEKxsoF4=; b=rjkQQ9pJJzXi7CcysRREp0YNcZr3CP8MVjgs3LjMBMjtlHZjp4Zwn73muJ6K/lGTT0 gGPG0FcYwfpPCiH5tSFIFK1ZSa3nxmZiO/ccx4hoVQta3vojIePUHbSPSOk4aI3wzbmo Sz7Dz2qbCRaSzyI8/o6EytrSwNxsVf/D7edOYKt+Rm1rTITNtVtRv6qHfeCDxuqgK4wz Ykykpa9usibfZdH7mA7xIpgEISRHQYCKjTqNr6Fp/Ikz22JoguPZBVOZYlSAwFyE0Ffm MGPMT6v4ABQCpZxY/VhVEiMTIcvCrpJSWrTb4osgTjWYpkjqXyDaef/N3UUrmR2mT+Ew Khxw==
X-Gm-Message-State: AOAM533fLRRJgcVRLSTFKIF7VG4PA0iM6Qn4z7GxUs91ALfvlLklJzUs cLiYFeEYsmU8aqxWTcA4D/I=
X-Google-Smtp-Source: ABdhPJxokuVWoAvvjBtHDUT4DjbcGXanFHnL9DXSJrQVVF1qWm0qy1NTHANiFIg+dQaTQ8hbTHeigA==
X-Received: by 2002:adf:ec50:: with SMTP id w16mr2038001wrn.265.1603930569627; Wed, 28 Oct 2020 17:16:09 -0700 (PDT)
Received: from ?IPv6:2601:647:5a00:ef0b:5083:8adc:a63c:2546? ([2601:647:5a00:ef0b:5083:8adc:a63c:2546]) by smtp.gmail.com with ESMTPSA id x3sm1367288wmi.45.2020.10.28.17.16.07 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 28 Oct 2020 17:16:08 -0700 (PDT)
From: Bob Hinden <bob.hinden@gmail.com>
Message-Id: <C995D532-B461-4613-88F7-758A45301B9A@gmail.com>
Content-Type: multipart/signed; boundary="Apple-Mail=_1DA997A3-734C-4B92-B49F-51E401C1EEB7"; protocol="application/pgp-signature"; micalg="pgp-sha512"
Mime-Version: 1.0 (Mac OS X Mail 12.4 \(3445.104.17\))
Date: Wed, 28 Oct 2020 17:16:04 -0700
In-Reply-To: <29510.1603929051@localhost>
Cc: Bob Hinden <bob.hinden@gmail.com>, Paul Wouters <paul@nohats.ca>, Tools Team Discussion <tools-discuss@ietf.org>, Henrik Levkowetz <henrik@levkowetz.com>
To: Michael Richardson <mcr+ietf@sandelman.ca>
References: <alpine.LRH.2.23.451.2010281420240.2537787@bofh.nohats.ca> <438c0bc7-ceed-c77b-4846-75f26e477ae9@levkowetz.com> <6756.1603915195@localhost> <alpine.LRH.2.23.451.2010281616550.2540588@bofh.nohats.ca> <29510.1603929051@localhost>
X-Mailer: Apple Mail (2.3445.104.17)
Archived-At: <https://mailarchive.ietf.org/arch/msg/tools-discuss/2uYhtEgqUQJw8JRO2KLi_zwBDq0>
Subject: Re: [Tools-discuss] mangled ToC in RFC 8784
X-BeenThere: tools-discuss@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: IETF Tools Discussion <tools-discuss.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/tools-discuss/>
List-Post: <mailto:tools-discuss@ietf.org>
List-Help: <mailto:tools-discuss-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/tools-discuss>, <mailto:tools-discuss-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 29 Oct 2020 00:17:00 -0000


> On Oct 28, 2020, at 4:50 PM, Michael Richardson <mcr+ietf@sandelman.ca> wrote:
> 
> Signed PGP part
> 
> Paul Wouters <paul@nohats.ca> wrote:
>>>>> This RFC seems to have a mangled ToC that cannot be clicked at.
> 
>>> I gotta ask if it's worth fixing?
> 
>> Yes it is. What's the point of a ToC if I can't use it to go to a
>> specific section.
> 
> I agree that the TOC is useless in this form.
> I'm asking what would make the HTML version more useable to you?
> I also find it different and weird, but I'm starting to accept it.
> 
> The best part of the tools htmlized version is that it, by default, seems to
> fill most of my screen (fit-width), while the various other versions I have
> to adjust things, and sometimes it just never looks right.
> The DT copy of the htmlization suffers from this in particular.
> 
> The HTML output is naturally much more reactive, but I still find that there
> is too much wasted white space.

I agree with what Michael said.

Bob