All - (ed) Add readers note in terminology how to read them in the main text
Issue #859
resolved
People are reading the spec sloppily. An instruction to the readers as follows may help.
NOTE: TERMINOLGY FORMS A NORMATIVE PORTION OF THIS SPECIFICATION AND MUST BE FOLLOWED. All the capitalized words in the main text are defined words. e.g., Issuer Identifier. Whenever the reader encounters them, they MUST refer back to this section to find the definition.
Comments (3)
-
-
- changed milestone to Implementer's Draft
-
assigned issue to
We will supply this reader's note. I plan to change "Note:" to "IMPORTANT NOTE TO READERS:" to draw more attention to it.
-
- changed status to resolved
Fixed
#859- Added IMPORTANT NOTE TO READERS about the terminology definitions being a normative part of the specification.→ <<cset 4a0f8545dc54>>
- Log in to comment
Proposed slight rewrite to read more naturally:
NOTE: The terminology definitions in this section are a normative portion of this specification, imposing requirements upon implementations. All the capitalized words in the text of this specification, such as “Issuer Identifier”, reference these defined terms. Whenever the reader encounters them, their definitions found in this section must be followed.