Subject: [fdt] Fwd: New Version Notification for draft-mcquistin-augmented-ascii-diagrams-07.txt

From: Stephen McQuistin <[email-masked]>
Date: Tue, 10 Nov 2020 12:16:44 +0000

Hi all,

We recently submitted a new version of draft-mcquistin-augmented-ascii-diagrams, which includes minor clarifications to the format, and pointers to examples that use it. 

The example drafts are:
	- draft-mcquistin-quic-augmented-diagrams
	- draft-mcquistin-augmented-udp-example
	- draft-mcquistin-augmented-tcp-example

We have also released an updated version of our tooling which can be found at https://github.com/glasgow-ipl/ips-protodesc-code <https://github.com/glasgow-ipl/ips-protodesc-code>. This tooling will parse the example drafts, derive a definition of the protocols they specify, and generate parser code (in Rust).

For some of these example drafts, it is instructive to compare them with the existing drafts/RFCs that specify the same protocols. In particular, draft-mcquistin-augmented-tcp-example has been written to allow it to be compared with draft-ietf-tcpm-rfc793bis. This helps to highlight places where the augmented diagram format needs to be made more flexible or more natural to read/write.

Feedback on the drafts, tooling, and generated code is welcome.

Thanks,

Stephen

> Begin forwarded message:
> 
> From: [email-masked]
> Subject: New Version Notification for draft-mcquistin-augmented-ascii-diagrams-07.txt
> Date: 2 November 2020 at 22:26:14 GMT
> To: "Vivian Band" <[email-masked]>, "Dejice Jacob" <[email-masked]>, "Colin Perkins" <[email-masked]>, "Stephen McQuistin" <[email-masked]>
> 
> 
> A new version of I-D, draft-mcquistin-augmented-ascii-diagrams-07.txt
> has been successfully submitted by Stephen McQuistin and posted to the
> IETF repository.
> 
> Name:		draft-mcquistin-augmented-ascii-diagrams
> Revision:	07
> Title:		Describing Protocol Data Units with Augmented Packet Header Diagrams
> Document date:	2020-11-02
> Group:		Individual Submission
> Pages:		27
> URL:            https://www.ietf.org/archive/id/draft-mcquistin-augmented-ascii-diagrams-07.txt
> Status:         https://datatracker.ietf.org/doc/draft-mcquistin-augmented-ascii-diagrams/
> Html:           https://www.ietf.org/archive/id/draft-mcquistin-augmented-ascii-diagrams-07.html
> Htmlized:       https://tools.ietf.org/html/draft-mcquistin-augmented-ascii-diagrams-07
> Diff:           https://www.ietf.org/rfcdiff?url2=draft-mcquistin-augmented-ascii-diagrams-07
> 
> Abstract:
>   This document describes a machine-readable format for specifying the
>   syntax of protocol data units within a protocol specification.  This
>   format is comprised of a consistently formatted packet header
>   diagram, followed by structured explanatory text.  It is designed to
>   maintain human readability while enabling support for automated
>   parser generation from the specification document.  This document is
>   itself an example of how the format can be used.
> 
> 
> 
> 
> Please note that it may take a couple of minutes from the time of submission
> until the htmlized version and diff are available at tools.ietf.org.
> 
> The IETF Secretariat
> 
>