Re: [rfc-i] I need your "good" RFCs

Joseph Touch <touch@strayalpha.com> Fri, 12 February 2021 04:37 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 A46683A11D9; Thu, 11 Feb 2021 20:37:08 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.471
X-Spam-Level:
X-Spam-Status: No, score=-2.471 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_INVALID=0.1, DKIM_SIGNED=0.1, HEADER_FROM_DIFFERENT_DOMAINS=0.249, MAILING_LIST_MULTI=-1, RCVD_IN_MSPIKE_H4=-0.01, RCVD_IN_MSPIKE_WL=-0.01, 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 (message has been altered)" header.d=strayalpha.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 pUWzn7iCntTW; Thu, 11 Feb 2021 20:37:07 -0800 (PST)
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 0DECD3A11D6; Thu, 11 Feb 2021 20:37:05 -0800 (PST)
Received: from rfcpa.amsl.com (localhost [IPv6:::1]) by rfc-editor.org (Postfix) with ESMTP id 2CF68F40738; Thu, 11 Feb 2021 20:36:35 -0800 (PST)
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 E910AF40738 for <rfc-interest@rfc-editor.org>; Thu, 11 Feb 2021 20:36:34 -0800 (PST)
X-Virus-Scanned: amavisd-new at rfc-editor.org
Authentication-Results: rfcpa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=strayalpha.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 ok2Wj9SqzLHg for <rfc-interest@rfc-editor.org>; Thu, 11 Feb 2021 20:36:31 -0800 (PST)
Received: from server217-5.web-hosting.com (server217-5.web-hosting.com [198.54.116.226]) by rfc-editor.org (Postfix) with ESMTPS id 1F839F4070A for <rfc-interest@rfc-editor.org>; Thu, 11 Feb 2021 20:36:31 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=strayalpha.com; s=default; h=To:References:Message-Id: Content-Transfer-Encoding:Cc:Date:In-Reply-To:From:Subject:Mime-Version: Content-Type:Sender:Reply-To:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=ru3hjbxC3sYFVd4VHKpPXxLW9Kfm/6uc+Fkvgnnf8SI=; b=eJGaaS98sPMxDf08CIlr8XE0S 5Fe6kcD9R+3nd5PabuBtAeXv3shvKdrBGYi0oyMl/95deXUD/QiY2+XYtnc06emz0VXYkiCYZz8c4 LUWt8Hz62nu5TAOn7pL4D+jdFBkARm7e5jaHsDi+y954R2Wa5fSfP3AVadSBtewME0mLPtwjEVSdC WMfY1qibXoztcRQz15bPyJNFjTtNk3gZYxcG4lMzoyHv+2bIBT2BMQ85XSt+k5z8xdI8L337yxjeu gUqZvM9RRNtz7n7iZ/VJNEI6fnBYxVaG6e4Z53aK2RK2WNWk3dd240QpEvL30BcldJ5em1tTTIQmC s7NhpwrRA==;
Received: from cpe-172-250-225-198.socal.res.rr.com ([172.250.225.198]:53925 helo=[192.168.1.14]) by server217.web-hosting.com with esmtpsa (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.93) (envelope-from <touch@strayalpha.com>) id 1lAQCN-000Tkk-B7; Thu, 11 Feb 2021 23:37:00 -0500
Mime-Version: 1.0 (Mac OS X Mail 14.0 \(3654.60.0.2.21\))
From: Joseph Touch <touch@strayalpha.com>
In-Reply-To: <ybltuqijmul.fsf@w7.hardakers.net>
Date: Thu, 11 Feb 2021 20:36:54 -0800
Message-Id: <0D6C0B4B-0081-412E-9C12-89FFF40C225F@strayalpha.com>
References: <ybltuqijmul.fsf@w7.hardakers.net>
To: Wes Hardaker <wjhns1@hardakers.net>
X-Mailer: Apple Mail (2.3654.60.0.2.21)
X-OutGoing-Spam-Status: No, score=-1.0
X-AntiAbuse: This header was added to track abuse, please include it with any abuse report
X-AntiAbuse: Primary Hostname - server217.web-hosting.com
X-AntiAbuse: Original Domain - rfc-editor.org
X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12]
X-AntiAbuse: Sender Address Domain - strayalpha.com
X-Get-Message-Sender-Via: server217.web-hosting.com: authenticated_id: touch@strayalpha.com
X-Authenticated-Sender: server217.web-hosting.com: touch@strayalpha.com
X-Source:
X-Source-Args:
X-Source-Dir:
X-From-Rewrite: unmodified, already matched
Subject: Re: [rfc-i] I need your "good" RFCs
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>
Cc: RFC Interest <rfc-interest@rfc-editor.org>
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: base64
Errors-To: rfc-interest-bounces@rfc-editor.org
Sender: rfc-interest <rfc-interest-bounces@rfc-editor.org>


> On Feb 11, 2021, at 1:50 PM, Wes Hardaker <wjhns1@hardakers.net> wrote:
> 
> 
> Good folks,
> 
> I'm looking for people's favorite RFCs with respect to readability and
> understand-ability.  

RFC793 remains a great model for how to spec a protocol - including defining the internal state machine AND the abstract API.

Especially because it predates the decision* that APIs weren’t part of protocols.

Joe

* regrettably and incorrectly.
_______________________________________________
rfc-interest mailing list
rfc-interest@rfc-editor.org
https://www.rfc-editor.org/mailman/listinfo/rfc-interest