core-wg / resource-directory

The CoRE WG draft for the Resource Directory
Other
9 stars 4 forks source link

definitions: Why Does English Not Have Operator Precedence Overruling Parentheses? #317

Closed chrysn closed 3 years ago

chrysn commented 3 years ago

From follow-up on Ben's initial DISCUSS:

Resource Directory (RD) A web entity that stores information about web resources and implements the REST interfaces defined in this specification for discovery, for the creation, the maintenance and the removal of registrations, and for lookup of the registered resources.

nit: the list structure is not parallel here. Maybe "for discovery, creation, maintenance, and removal of registrations, and for lookup of the registered resources"?

response:

The intended structure that's linearized into the sadly untreeish structure of written language was

  • discovery
  • of registrations
    • creation
    • maintenance
    • removal
  • lookup

Ah! In that case, I'd suggest using semicolons for the "outer" list, and commas for separating creation/maintenance/removal.

It'd sound like abuse of semicolons to me; keeping it open to ask RFC editor for their technical writing expertise.