On Sat, 30 May 2026 at 01:13, Tero Kivinen <[email protected]> wrote: > > Scott Hollenbeck writes: > > > In addition of those two bigger issues, there are several cases > > > where RFC numbers are used without any useful title or text > > > describing which document they refer to. This makes it harder for > > > the newcomers to read IETF documents, as to be able to read a document > > > you first need to have the mapping from 10000 RFC numbers to the > > > titles of those RFCs. To make documents easier to read for people > > > who are not experts in that area (i.e., who do not have the RFC > > > number mappings memorized), add short title before referencing > > > an RFC. The RFC number can still stay in the actual reference > > > link. > > > > > > Below is the list of such cases in this document, and proposed text > > > to correct those: > > > > [SAH] I'm going to defer to Med for this one, too. In my experience > > the RFC Editor commonly accepts citations as currently found in the > > draft. > > RFC Editor do accept citations in that format, but that does not mean > it is good idea to have citations in that format. When we only had > 1500 or so RFCs published when I started participating in the IETF, it > was mostly manageable to learn mapping from each RFC number to the > actual contents, especially for your own area. > > Now when we have 10000 of those, at least my capability is not large > enough to be able to map them in my head, and adding few words while > writing the document (i.e., some kind of title) makes reading the > document much easier. The title does not have to match exactly to the > RFC title, but it should be something that gives reader good > understanding what that RFC is about. > > I do hope even this document will have more readers than writers, so > overall time saving will be there... > -- > [email protected] >
Hi both, For what it's worth, as a comparative newcomer to the community, I find Tero's suggested wording much easier to process - I do spend a certain amount of time flipping about following references in order to remind myself which number maps to which concept. Ruth _______________________________________________ regext mailing list -- [email protected] To unsubscribe send an email to [email protected]
