IETF Logo Mail Archive

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

Brian E Carpenter <brian.e.carpenter@gmail.com> Sun, 01 November 2020 01:58 UTC

Return-Path: <rfc-interest-bounces@rfc-editor.org>
X-Original-To: ietfarch-rfc-interest-archive@ietfa.amsl.com
Delivered-To: ietfarch-rfc-interest-archive@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id A183D3A0D02; Sat, 31 Oct 2020 18:58:59 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.445
X-Spam-Level:
X-Spam-Status: No, score=-2.445 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_ADSP_CUSTOM_MED=0.001, DKIM_INVALID=0.1, DKIM_SIGNED=0.1, FREEMAIL_FORGED_FROMDOMAIN=0.25, FREEMAIL_FROM=0.001, HEADER_FROM_DIFFERENT_DOMAINS=0.25, MAILING_LIST_MULTI=-1, NICE_REPLY_A=-0.247, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=fail (2048-bit key) reason="fail (body has been altered)" 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 dmN6oCeRFAYI; Sat, 31 Oct 2020 18:58:58 -0700 (PDT)
Received: from rfc-editor.org (rfc-editor.org [4.31.198.49]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 59D413A0D01; Sat, 31 Oct 2020 18:58:58 -0700 (PDT)
Received: from rfcpa.amsl.com (localhost [IPv6:::1]) by rfc-editor.org (Postfix) with ESMTP id A9E5BF40716; Sat, 31 Oct 2020 18:58:41 -0700 (PDT)
X-Original-To: rfc-interest@rfc-editor.org
Delivered-To: rfc-interest@rfc-editor.org
Received: from localhost (localhost [127.0.0.1]) by rfc-editor.org (Postfix) with ESMTP id 6BA16F40716 for <rfc-interest@rfc-editor.org>; Sat, 31 Oct 2020 18:58:40 -0700 (PDT)
X-Virus-Scanned: amavisd-new at rfc-editor.org
Authentication-Results: rfcpa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com
Received: from rfc-editor.org ([127.0.0.1]) by localhost (rfcpa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id NcbpghzZmmCJ for <rfc-interest@rfc-editor.org>; Sat, 31 Oct 2020 18:58:36 -0700 (PDT)
Received: from mail-pj1-x1033.google.com (mail-pj1-x1033.google.com [IPv6:2607:f8b0:4864:20::1033]) by rfc-editor.org (Postfix) with ESMTPS id 9E898F40711 for <rfc-interest@rfc-editor.org>; Sat, 31 Oct 2020 18:58:36 -0700 (PDT)
Received: by mail-pj1-x1033.google.com with SMTP id k1so1399768pjd.5 for <rfc-interest@rfc-editor.org>; Sat, 31 Oct 2020 18:58:52 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:references:from:message-id:date:user-agent:mime-version :in-reply-to:content-language:content-transfer-encoding; bh=GZuQeUdtlQDyzX7WNwpQeiOF6Y6mwYOsBl1Yy/HN4hU=; b=aquhezMQjXoU52X2I6fqvoE6F2DepUVeoWVrkGp87HZgkW+EB0mKy6fsLl2hHlU9bu 9GB6UkaZOx2S1cKz9zqjnNW426UMofIv1h1fJgVEUw8SZOKbfOAVJILAZR448N5TcsTc Y0iTvrXq+MCfayHU5Y4vG5C6hUTPEpSCNArs2ZlXbORientalVtYgzdq4UygAQ8Z8zpe 0szRS+kzfynqHJTkdEpiy5WH0USr8kkYV3AiGSA9GdTvD/nc8BSNmQqr0pQdGZcjTMGR WoFZPkutCowVQTqcbGxGaoYFl9xYeJLtTNFUo08Bvc9FPaA03gEnarGRJFlgRwGBvdHe Lj/w==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-language :content-transfer-encoding; bh=GZuQeUdtlQDyzX7WNwpQeiOF6Y6mwYOsBl1Yy/HN4hU=; b=goaY/nmtE14WH/BOSN4C1E7wG+8e6989GwbuJWvpZ98GkmCvO4u+MvpUXjnwjyjeQv TvwJZ/4fJA9tliv9EZCVQuvAVwJdA/5DK2crcVz3QNN7zxv5q/7Ht6gbvyYTZYQizPl7 3ErcXwKyWSl0LB9cOiitx0titstO7F5ZaMgjEpx4VL5gJ8O0SrG7BYEqHnlAu61QKjQ+ 72KjLtDF30LN2zckbzZfNvduE9SbyizBJKiSzTrydTddgTFNxno6QZ7OzFLZ2Oy0jS2i 4dnjtgoFNBXVHijui9EWN3jPv1XlYz/mAlaF8pJuiuNXXu2JV5MIj5YBCYA5pOb09Y7V FI9w==
X-Gm-Message-State: AOAM530DLkeqRZJSP6MsAQbn39mpktg/oz/md058RDrj2xTC0wt+FYD4 fkVGiBJ2NnF9UeI+SruWk8i+1Jt0PtDbMQ==
X-Google-Smtp-Source: ABdhPJxV4lR7q6sr57nEjHZxlCi+SWMvCpA77m/LQsoz4MpXtvY/8T7pP6aYCqnrERhibz6Dl3p2iQ==
X-Received: by 2002:a17:902:23:b029:d5:b88a:c782 with SMTP id 32-20020a1709020023b02900d5b88ac782mr15291608pla.5.1604195931951; Sat, 31 Oct 2020 18:58:51 -0700 (PDT)
Received: from [192.168.178.20] ([151.210.130.0]) by smtp.gmail.com with ESMTPSA id d26sm9662584pfo.82.2020.10.31.18.58.49 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Sat, 31 Oct 2020 18:58:51 -0700 (PDT)
To: "John R. Levine" <johnl@iecc.com>, rfc-interest@rfc-editor.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> <e8554ea2-1849-279f-733d-5798de8817b9@gmail.com> <26d1ff54-777f-884b-e35-d91e9fe59662@iecc.com>
From: Brian E Carpenter <brian.e.carpenter@gmail.com>
Message-ID: <00a1fc15-7559-96c6-7cd7-3ae5afd62237@gmail.com>
Date: Sun, 01 Nov 2020 14:58:46 +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: <26d1ff54-777f-884b-e35-d91e9fe59662@iecc.com>
Content-Language: en-US
Subject: Re: [rfc-i] [Rsoc] RFCs with page numbers (pretty please) ?
X-BeenThere: rfc-interest@rfc-editor.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "A list for discussion of the RFC series and RFC Editor functions." <rfc-interest.rfc-editor.org>
List-Unsubscribe: <https://www.rfc-editor.org/mailman/options/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=unsubscribe>
List-Archive: <http://www.rfc-editor.org/pipermail/rfc-interest/>
List-Post: <mailto:rfc-interest@rfc-editor.org>
List-Help: <mailto:rfc-interest-request@rfc-editor.org?subject=help>
List-Subscribe: <https://www.rfc-editor.org/mailman/listinfo/rfc-interest>, <mailto:rfc-interest-request@rfc-editor.org?subject=subscribe>
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Errors-To: rfc-interest-bounces@rfc-editor.org
Sender: rfc-interest <rfc-interest-bounces@rfc-editor.org>

On 01-Nov-20 14:38, John R. Levine wrote:
> On Sun, 1 Nov 2020, Brian E Carpenter wrote:
>>> 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.
> 
> I think you may be confusing fragment identifiers in URLs with textual 
> comments.  My point was that if you want a mechanical reference to a 
> section in an RFC, the RFCs we publish now have them.

Indeed. I was trying to underline that section titles are just about the only format-independent reference target that we have.

    Brian
_______________________________________________
rfc-interest mailing list
rfc-interest@rfc-editor.org
https://www.rfc-editor.org/mailman/listinfo/rfc-interest

v2.23.0 | Report a Bug | By Email