design icon indicating copy to clipboard operation
design copied to clipboard

More clarity around position of Name Section

Open sbc100 opened this issue 8 years ago • 2 comments

BinaryEncoding.md currently says The name section may appear only once, and only after the Data section.

The spec currently says: The name section should appear only once in a module, and only after the data section.

This doesn't make sense for modules that don't have a data section at all. What I think the author intended is ..only after all known sections. To me it makes sense that the name section come after all known sections (even ones that are yet to be added) since I could be used to name elements in any of the known sections.

Technically as it stands today the name section only really needs to follow the Function section (since it can only name function) but I think forcing to come after all known sections make the most sense from a forward looking perspective.

sbc100 avatar Jan 17 '18 18:01 sbc100

Until we add other known sections 😉 I think we should provide an ordering with current known sections.

jfbastien avatar Jan 17 '18 19:01 jfbastien

OK, but the main point is that after the data sectionis not the right wording for that.

sbc100 avatar Jan 17 '18 19:01 sbc100