search

whatwg / storage

Storage Standard
https://storage.spec.whatwg.org/
Other
126 stars 55 forks source link

Awkward wording in Section 4.3 Storage sheds #99

Open othermaciej opened 4 years ago

othermaciej commented 4 years ago

https://storage.spec.whatwg.org/#storage-sheds

The following phrasings seem tautological:

A user agent holds a storage shed, which is a storage shed.

A browsing session holds a storage shed, which is a storage shed.

The first "storage shed" in each of these sentences is a term reference, the second is a link to the term in the same document. This doesn't seem worth the strange phrasing, since the term reference already provides a link.

annevk commented 4 years ago

This is a pretty common pattern in modern specifications. The first is a field (the field storage shed of user agent), the second is the type it holds. It's very useful to be able to reference these independently.