Overview and Suggestions pointers – Enterprise Ethereum Alliance


touch upon EEA paperwork

Please use the Contact Type on this web site to offer feedback on EEA Specs together with Overview Drafts and Editor’s Drafts, and different paperwork offered by way of this web site.

Please determine the precise model of specs and paperwork that present such info, e.g. “EthTrust Safety Ranges, Editor’s draft, 14 July 2032” or “EEA primer ‘Introduction to DAOs veersion 7′”, within the topic discipline, to ensdure the suggestions is efficeintly delivered to the related Group or employees member.

Producing useful suggestions

Useful suggestions on specs identifies

  • the related half(s) of the specification. EEA specs printed as HTML usually have part markers (“§”) which can be a hyperlink to the related part. Quoting that hyperlink is useful, along with noting the part identify and quantity.
  • the issue with the present textual content, or the addition advised. Whereas it’s useful to determine motion that might resolve the difficulty, you will need to clarify the issue because the Working Group could resolve a distinct decision is extra applicable.

Suggestions that means using a distinct definition, a change or enchancment to grammar, a damaged hyperlink, or the like, is greatest recognized as “Editorial”. Please word that the editor(s) of any specification, on the course of the related Working Group, take accountability for selections on writing fashion.

Suggestions that identifies an issue with the content material itself, reminiscent of noting an erroroneous assertion, or a suggestion {that a} specification ought to embody content material it doesn’t at present handle, is substantive and can be thought of by the Working Group as an entire. The Working Group would possibly ask for additional clarification to assist it resolve the difficulty appropriately.

Good Suggestions would possibly seem like:

Part B.6 (vii) “Attention-grabbing Fruit” of the 14 January Editor’s Draft of “Lunch concepts” <https://ift.tt/KPcpoNe> incorporates Editorial and Substantive errors:

  • Substantive: It fails to say donuts, and it contains persimmons however they aren’t attention-grabbing
  • Editorial: The widespread spelling is “donuts”, not “dough-nuts”. The spelling used will confuse the worldwide viewers of this specification.
  • Editorial: Using double- and triple-negatives and never writing in a approach that doesn’t use passive voice just isn’t conducive to straightforward understanding. Please think about rephrasing this.

Nevertheless suggestions reminiscent of

The specification takes the mistaken method, as a result of it doesn’t handle the concepts of Shevchenko on Mishima’s later works correctly.

Is tough to course of. Whereas it means that one thing is lacking, it fails to clarify what that’s (which concepts of Shevchenko?), nor give an understanding of the way it might be mounted. Additional, it doesn’t determine in any approach which elements of the specification are problematic.



Supply hyperlink



from Ethereum – My Blog https://ift.tt/RM6ul9c
via IFTTT

Post a Comment

Previous Post Next Post

Cryptocurrency