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

Make it clear that quota is not supposed to be a function of availabl… #108

Merged
merged 2 commits into from
Jul 8, 2020
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
22 changes: 14 additions & 8 deletions storage.bs
Original file line number Diff line number Diff line change
Expand Up @@ -471,20 +471,26 @@ locally.

<h2 id=usage-and-quota>Usage and quota</h2>

<p>The <dfn export>storage usage</dfn> of a <a>storage shelf</a> is a rough estimate of the amount
of bytes used by it.
<p>The <dfn export>storage usage</dfn> of a <a>storage shelf</a> is an <a>implementation-defined</a>
rough estimate of the amount of bytes used by it.

<p class=note>This cannot be an exact amount as user agents might, and are encouraged to, use
deduplication, compression, and other techniques that obscure exactly how much bytes a
<a>storage shelf</a> uses.

<p>The <dfn export>storage quota</dfn> of a <a>storage shelf</a> is a conservative estimate of the
total amount of bytes it can hold. This amount should be less than the total available storage space
on the device to give users some wiggle room.
<p tracking-vector>The <dfn export>storage quota</dfn> of a <a>storage shelf</a> is an
<a>implementation-defined</a> conservative estimate of the total amount of bytes it can hold. This
amount should be less than the total storage space on the device. It must not be a function of the
available storage space on the device.

<p class=note>User agents are strongly encouraged to consider navigation frequency, recency of
visits, bookmarking, and <a href="#persistence">permission</a> for {{"persistent-storage"}} when
evaluating quotas.
<div class=note>
<p>User agents are strongly encouraged to consider navigation frequency, recency of visits,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Putting "strong encouragements" in non-normative notes instead of as "shoulds" is a bit weird.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Well, these are suggestions. They are not really directly observable so it seems weird to require them.

bookmarking, and <a href="#persistence">permission</a> for {{"persistent-storage"}} when
determining quotas.

<p>Directly or indirectly revealing available storage space can lead to fingerprinting and leaking
information outside the scope of the <a for=/>origin</a> involved.
</div>



Expand Down