ietf-wg-bpf / ebpf-docs

eBPF Standard Documentation
37 stars 5 forks source link

ISA: document title question #89

Closed dthaler closed 4 months ago

dthaler commented 5 months ago

The Internet Draft filename is draft-ietf-bpf-isa-XX, and the charter has:

[PS] the BPF instruction set architecture (ISA) that defines the instructions and low-level virtual machine for BPF programs,

That is, "instruction set architecture (ISA)", but the document itself has:

=======================================
BPF Instruction Set Specification, v1.0 
=======================================

This document specifies version 1.0 of the BPF instruction set.

Notably, no "architecture (ISA)". Also, we now have a mechanism to extend it with conformance groups over time, so "v1.0" seems less relevant and perhaps not important given there's only one version being standardized at present.

What about changing the doc to say:

=======================================
BPF Instruction Set Architecture
=======================================

This document specifies the BPF instruction set architecture (ISA).

?

dthaler commented 5 months ago

Question posted to list at https://mailarchive.ietf.org/arch/msg/bpf/SEpn3OL9TabNRn-4rDX9A6XVbjM/

dthaler commented 5 months ago

Patch posted: https://mailarchive.ietf.org/arch/msg/bpf/NeURxAIvEURLIlHWMx08u9xetTc/

dthaler commented 4 months ago

Fixed in #99

dthaler commented 4 months ago

Fixed in draft -01