Skip to content

Commit

Permalink
Make it clear that quota is not supposed to be a function of availabl…
Browse files Browse the repository at this point in the history
…e space

Also make it clear usage and quota for storage shelves are ultimately implementation-defined.

Helps with #95 and #70.

Closes #106.
  • Loading branch information
annevk committed Jul 6, 2020
1 parent a85a7c5 commit fb25e93
Showing 1 changed file with 7 additions and 6 deletions.
13 changes: 7 additions & 6 deletions storage.bs
Original file line number Diff line number Diff line change
Expand Up @@ -471,20 +471,21 @@ 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>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.
determining quotas.



Expand Down

0 comments on commit fb25e93

Please sign in to comment.