tc39 / proposal-uuid

UUID proposal for ECMAScript (Stage 1)
463 stars 7 forks source link

docs: address some initial nits #2

Closed bcoe closed 5 years ago

bcoe commented 5 years ago

addressed some of the comments in #1, and from email conversation wit @littledan.

  1. don't commit to @std: import format, as this is contentious.
  2. remove the start of the algorithm definition; I gather we'll instead describe the algorithm at a higher level in a "Solution: standard module uuid" section of the README.
  3. change language referencing rfc4122 to "standard" from "proposal" ... I note that on the IETF lists this as a "PROPOSED STANDARD", are we correct to refer to a proposed standard as a standard?

@littledan you'd mentioned adding some acceptance tests, is there an example of how these tests are formatted in another TC39 proposal we could reference?