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

Brian E Carpenter <brian.e.carpenter@gmail.com> Sun, 01 November 2020 02:17 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 14A3C3A0DC9; Sat, 31 Oct 2020 19:17:18 -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 wCXaiMmm7iQz; Sat, 31 Oct 2020 19:17:16 -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 B15B43A0DC8; Sat, 31 Oct 2020 19:17:16 -0700 (PDT)
Received: from rfcpa.amsl.com (localhost [IPv6:::1]) by rfc-editor.org (Postfix) with ESMTP id 26FD1F40716; Sat, 31 Oct 2020 19:17:00 -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 A297CF40716 for <rfc-interest@rfc-editor.org>; Sat, 31 Oct 2020 19:16:59 -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 A7cusxdOdbKg for <rfc-interest@rfc-editor.org>; Sat, 31 Oct 2020 19:16:58 -0700 (PDT)
Received: from mail-pf1-x429.google.com (mail-pf1-x429.google.com [IPv6:2607:f8b0:4864:20::429]) by rfc-editor.org (Postfix) with ESMTPS id 7A0B5F40715 for <rfc-interest@rfc-editor.org>; Sat, 31 Oct 2020 19:16:58 -0700 (PDT)
Received: by mail-pf1-x429.google.com with SMTP id c20so8179823pfr.8 for <rfc-interest@rfc-editor.org>; Sat, 31 Oct 2020 19:17:14 -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=87TkqTN4iM01DFuzLf3ob74FbgJzpO1sNRGpXRZi0s0=; b=OSYnAzWCPSFfbgLUbBS5a5knx0CP543sMVal8k8u+QKcjnlZV5jRHw4a/DTmsgVTSm ms5KWDWnugliRw+L8X0gFpOkxgPJUZvQZjnZrl06gjw592ub7QGaEG0gX2+mv7bzWEUe 6bbq9yFXZaCEjubKTClK1MkJNNQRbO/tfDSot0F/Qqt5DQR6Q9YS+rGU4wz2HF7d2TyB o8UbXdm0MxFMaPCut7MRPWIZuSOoTJPr53IRGMMUZluWzDlF8zvE0izPldTNbAx+ZOtf hLG4TrEndESwQ6i59S4xIS2+qNhXhbH0VLEKtNBJy8k9pDa9f82VR85zP+uJ5F23iKXd Fn2g==
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=87TkqTN4iM01DFuzLf3ob74FbgJzpO1sNRGpXRZi0s0=; b=uCoGsEt7TDOUMx7u9aD9FUOQEEV36/GS7NXNXpqiZ9eSUoa9yutV5PfiT2ogcrtzO3 M+NE7zs6QXSrZsYcO8A3s/KUZEgqm3tz9HiHwtLBZNjYKnxKNogdClPTgIV7F5ZEj/kn yGqgSRI45g8zAf+BqTBUoo9Auyf7V5XssF9QBY9xp90/mfCNiMoQO5KEIF1fFNM+Xy9l QQmmQBLIdKb4JwtZLohLjf/UHIT8ccarNmx64oZOGQ5OBX/LTakML177Jt8pMFSBeYP1 URM3Gq9bj1oGDpTvnkM37pD70d5+hOTTCqIdD3gRVhM58FATPNL9z48F56nqwO6tCV76 P1LQ==
X-Gm-Message-State: AOAM530RUkZl7BqaawhW/HrPPhm2D5zKOcCQmbwXZvffDJ2nl/+bNW3L SeTF857aQuH8yvP58x2AtFnLJY1HGgB9Aw==
X-Google-Smtp-Source: ABdhPJzWfVWHvj9LHalX52HHMBc6pwA3bBp/b1koKt5ypK116JRYd74j6TsmHHwk7IBfmypr5F5IEg==
X-Received: by 2002:aa7:92c3:0:b029:163:d2d6:8db1 with SMTP id k3-20020aa792c30000b0290163d2d68db1mr15943836pfa.17.1604197033406; Sat, 31 Oct 2020 19:17:13 -0700 (PDT)
Received: from [192.168.178.20] ([151.210.130.0]) by smtp.gmail.com with ESMTPSA id h5sm9484440pfn.12.2020.10.31.19.17.10 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Sat, 31 Oct 2020 19:17:12 -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> <00a1fc15-7559-96c6-7cd7-3ae5afd62237@gmail.com> <a34f219b-7c76-4b48-4844-5af3cd4f344@iecc.com>
From: Brian E Carpenter <brian.e.carpenter@gmail.com>
Message-ID: <be8dce95-2b4c-52c8-7eda-8a9b127a6dd4@gmail.com>
Date: Sun, 01 Nov 2020 15:17:08 +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: <a34f219b-7c76-4b48-4844-5af3cd4f344@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 15:02, John R. Levine wrote:
>>> 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.
> 
> What formats do you believe don't have section numbers?  They're in all 
> three rendered formats and in the XML as tags like "section-3.1".

They aren't in raw XML and they aren't in kramdown, so they aren't where
an author needs them when processing comments on an I-D. (So, strictly,
that isn't an RFC format issue, but it is an issue created by our format
choices and it's quite an annoyance.)

Interestingly enough, I see that we used to have explicit section numbers
in nroff, like
   .XX"1.1. Usage Scenarios"
but the author had to do the numbering manually.

> 
> If you mean I-D's, you're right, the section number tags aren't added 
> until late in the RFC process by the preptool.

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