ISA document title question
The Internet Draft filename is draft-ietf-bpf-isa-XX, and the charter has:
Quoted 2 lines
[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:
Quoted 5 lines
=======================================
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 do folks think about changing the doc to say:
Quoted 5 lines
=======================================
BPF Instruction Set Architecture
=======================================This document specifies the BPF instruction set architecture (ISA).
?
Dave
Quoted 9 lines · On Wed, Feb 07, 2024 at 01:39:47PM -0800…
The Internet Draft filename is draft-ietf-bpf-isa-XX, and the charter has:
Quoted 2 lines
[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:
Quoted 4 lines
=======================================
BPF Instruction Set Specification, v1.0
=======================================
Quoted 6 lines
Quoted 1 line
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.
Not only this, but we may extend individual conformance groups to new versions, while leaving others the same. So versioning this document seems like the wrong granularity. If we want to version anything as 1.0, we should probably version the conformance groups.
Quoted 8 lines
What do folks think about changing the doc to say:
Quoted 5 lines
=======================================
BPF Instruction Set Architecture
=======================================This document specifies the BPF instruction set architecture (ISA).
?
+1
Thanks,
David
Quoted 17 lines · On Wed, Feb 7, 2024 at 1:39 PM <[email protected]>…
The Internet Draft filename is draft-ietf-bpf-isa-XX, and the charter has:
Quoted 2 lines
[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:
Quoted 5 lines
=======================================
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.
Quoted 7 lines
What do folks think about changing the doc to say:
Quoted 5 lines
=======================================
BPF Instruction Set Architecture
=======================================This document specifies the BPF instruction set architecture (ISA).
?
Good idea. Makes sense to me.