Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Awkward wording in Section 4.3 Storage sheds #99

Open
othermaciej opened this issue Jun 14, 2020 · 1 comment
Open

Awkward wording in Section 4.3 Storage sheds #99

othermaciej opened this issue Jun 14, 2020 · 1 comment

Comments

@othermaciej
Copy link

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
Copy link
Member

annevk commented Jun 15, 2020

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.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Development

No branches or pull requests

2 participants