IETF Logo Mail Archive

Re: [rfc-i] [Rsoc] RFCs with page numbers (pretty please) ?

Brian E Carpenter <brian.e.carpenter@gmail.com> Sat, 31 October 2020 21:24 UTC

Return-Path: <brian.e.carpenter@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 537EE3A003E for <wgchairs@ietfa.amsl.com>; Sat, 31 Oct 2020 14:24:50 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.345
X-Spam-Level:
X-Spam-Status: No, score=-2.345 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, NICE_REPLY_A=-0.247, 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 FdFJxY6Y9dUQ for <wgchairs@ietfa.amsl.com>; Sat, 31 Oct 2020 14:24:48 -0700 (PDT)
Received: from mail-pf1-x433.google.com (mail-pf1-x433.google.com [IPv6:2607:f8b0:4864:20::433]) (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 7DF0A3A0039 for <wgchairs@ietf.org>; Sat, 31 Oct 2020 14:24:48 -0700 (PDT)
Received: by mail-pf1-x433.google.com with SMTP id 10so7907048pfp.5 for <wgchairs@ietf.org>; Sat, 31 Oct 2020 14:24:48 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-language:content-transfer-encoding; bh=Stxa9VR/B5nuy879+SdTCrk6Ag0IT2HlZKCBgnBGnjg=; b=ty+e8ti7N20hYYFJnTELjzpl80cuoCUo9GU0vqodzRckeLdjLpqaM4RmCSDwF+evdK CVRh3aReV7xg3RLrirciwg2qDV86JlroB69qD6SEv8SZHWCVVwm9hoMyAzLg0KonpAEp eNo/unSi9hEH0nUOJLQgHxIIU1kQSBKGcbcDjSVb5nNQ4eBBI5xcpeQLlGquftBkVPnL 1QKeSk/l9fQL9XIOr5b52VM8Lj23cjmpjTROVTsI6KBPU7lkeE+E8chcK0qJn0NClY2F Ow69ZpxBQln9KBIcc7XoOooRszonGEd6ZlbjnUCBwCtHmpJqbhR/zAejVzxnAtThg+G+ vtcw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=Stxa9VR/B5nuy879+SdTCrk6Ag0IT2HlZKCBgnBGnjg=; b=Bc0f0khFTxK0tK+5Iat0GQpK5aI/sYh4AByXd5E9i1E+AaLpzfg7suHe+FRb1ENtEL hUZ9cbFg6cTiA2VkLNn+FSqVy6f4d/ecEKM6Xh1KDITGZONER2Tk7gchcVpofMOgMjcu CwGsjNPjKQZH4M9PiLIeU3wMkDbA2IZV04mwrzZpJ/ZzLvUpCHgpbn/4HwwPdpDvbb5t s9HkNiajVDjwveig0aodiLD4r66aqNWnoBLNCqjhMbFpX4Pgah2mWYorUOmzCV8wX4iW cUodYewZgxo5aEfHbCPULkXqU6+TyDh/vSKtCkwl3OEDHCbXkMjHMb5MGfVvdsy3ZPuo 5RNA==
X-Gm-Message-State: AOAM531CQdqTYny7mBV9ZzzjFlAZpL8n85onNWLWc23EEYTcRTjzQzK/ JSmkM183UxuYpwN+3bjlEeIwkSub314BLg==
X-Google-Smtp-Source: ABdhPJxyh57PJVHBAaeM0pFWtF/8Urbjg5bjFJiSi9i61sYBd8OllYka7IYnq0gViKcUpx5OafC12g==
X-Received: by 2002:a62:e516:0:b029:156:3b35:9423 with SMTP id n22-20020a62e5160000b02901563b359423mr14604737pff.19.1604179487553; Sat, 31 Oct 2020 14:24:47 -0700 (PDT)
Received: from [192.168.178.20] ([151.210.130.0]) by smtp.gmail.com with ESMTPSA id x4sm9504734pfj.114.2020.10.31.14.24.44 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Sat, 31 Oct 2020 14:24:46 -0700 (PDT)
Subject: Re: [rfc-i] [Rsoc] RFCs with page numbers (pretty please) ?
To: rfc-interest@rfc-editor.org, "John R. Levine" <johnl@iecc.com>, Larry Masinter <LMM@acm.org>
Cc: Working Group Chairs <wgchairs@ietf.org>
References: <20201026181442.GA2438@faui48f.informatik.uni-erlangen.de> <CADaq8jdSeTDWy_0fCV25ykxKFMV1ZBtUMMNesoOuaXCzFVfpOA@mail.gmail.com> <D2D0455D-8D6C-4A19-ACAE-4DD972D83DC1@bluepopcorn.net> <20201028164053.GB12700@faui48f.informatik.uni-erlangen.de> <263C265C19B24BA97AF48934@PSB> <225062D7-C061-4543-8665-53A4F4831510@isc.org> <20201029005519.GT39170@kduck.mit.edu> <A05242FC-C38C-474F-A2AC-412329CA5C52@isc.org> <CAKq15ve-kAFZWH_f7=1XXC5PfxvO-sAzppB1fVTyqUufLftkVg@mail.gmail.com> <D2DB703DBF2A44A19B8F80DD@PSB> <CAKq15vdFVkG6_grNtqUqq-yDwj9QQcHJFZB5+RB-8fdxQXhFSw@mail.gmail.com> <fa36e919-b1a0-5b3c-9b42-54c6fdaadfb@iecc.com>
From: Brian E Carpenter <brian.e.carpenter@gmail.com>
Message-ID: <e8554ea2-1849-279f-733d-5798de8817b9@gmail.com>
Date: Sun, 01 Nov 2020 10:24:41 +1300
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:60.0) Gecko/20100101 Thunderbird/60.9.1
MIME-Version: 1.0
In-Reply-To: <fa36e919-b1a0-5b3c-9b42-54c6fdaadfb@iecc.com>
Content-Type: text/plain; charset="utf-8"
Content-Language: en-US
Content-Transfer-Encoding: 7bit
Archived-At: <https://mailarchive.ietf.org/arch/msg/wgchairs/v4GCbSq_zGBBrpqt4aP9yWdm0bo>
X-BeenThere: wgchairs@ietf.org
X-Mailman-Version: 2.1.29
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, 31 Oct 2020 21:24:50 -0000

On 01-Nov-20 10:12, John R. Levine wrote:
> [ please note reply-to ]
> 
> On Sat, 31 Oct 2020, Larry Masinter wrote:
>> I don't know how widely https://tools.ietf.org/html/rfc8118#section-3 is
>> implemented.
> 
> Every RFC on the tools site has fragment IDs for the sections, in the 
> native html in recent RFCs and the htmlized version of older ones.  This 
> particular issue was fully addressed a long time ago.
> 
> See, for example
> 
> https://tools.ietf.org/rfc/rfc793#section-3.1

For a while now, as a reviewer I have been trying to remember to use something like this in my reviews:

  Section 3.1 (Header Format):

  > Note that one tick mark represents one bit position.

  Please use a more accurate description than "tick mark".
  There are no tick marks in the diagram.

I know from experience as an XML author that I can find "Header Format" trivially, but finding a section number is fiddly & confusing, especially if a draft has recently been reorganised. Much the same goes for page numbers, if the author is using a different format than the reviewer, which is increasingly the case today.

    Brian

v2.23.0 | Report a Bug | By Email