Skip to content

Commit 46f87f5

Browse files
committed
Explain the UI guidelines a little better
Fixes the “source” comment in #23.
1 parent 4e9e562 commit 46f87f5

File tree

2 files changed

+15
-13
lines changed

2 files changed

+15
-13
lines changed

storage.bs

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -173,14 +173,15 @@ and <a>permission</a> for "<code>persistent-storage</code>" can be used as indic
173173

174174
User agents should not distinguish between network storage and <a>site storage</a> in their user
175175
interface. Instead user agents should offer users the ability to remove all storage for a given
176-
<a>site</a>. This ensures that storage from one source cannot be used to revive storage from another
177-
source. This also helps users avoid having to know about the different ways in which <a>sites</a>
178-
can store data.
179-
180-
<p class=XXX>This is still a concern due to HTTP ETag...
181-
182-
Credentials storage should still be separated however as it might contain data the user might not be
183-
able to revive, such as an autogenerated password.
176+
<a>site</a>. This ensures to some extent that network storage cannot be used to revive
177+
<a>site storage</a>. This also reduces the amount users need to know about the different ways in
178+
which <a>sites</a> can store data.
179+
<!-- To some extent, since HTTP ETag... And also, permissions/credentials, maybe? -->
180+
181+
Credentials storage should be separated as it might contain data the user might not be able to
182+
revive, such as an autogenerated password. Since permissions storage is mostly simple booleans it
183+
too can be separated to avoid inconveniencing the user. Credentials and permissions are also
184+
somewhat easier to understand and differentiate from network storage and <a>site storage</a>.
184185

185186

186187
<h3 id=storage-pressure>Storage Pressure</h3>

storage.html

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -215,11 +215,12 @@ <h2 class="heading settled" data-level="5" id="usage-and-quota"><span class="sec
215215
"popularity". </p>
216216
<h2 class="heading settled" data-level="6" id="ui-guidelines"><span class="secno">6. </span><span class="content">User Interface Guidelines</span><a class="self-link" href="#ui-guidelines"></a></h2>
217217
<p>User agents should not distinguish between network storage and <a data-link-type="dfn" href="#site-storage">site storage</a> in their user
218-
interface. Instead user agents should offer users the ability to remove all storage for a given <a data-link-type="dfn" href="#site">site</a>. This ensures that storage from one source cannot be used to revive storage from another
219-
source. This also helps users avoid having to know about the different ways in which <a data-link-type="dfn" href="#site">sites</a> can store data.</p>
220-
<p class="XXX">This is still a concern due to HTTP ETag... </p>
221-
<p>Credentials storage should still be separated however as it might contain data the user might not be
222-
able to revive, such as an autogenerated password.</p>
218+
interface. Instead user agents should offer users the ability to remove all storage for a given <a data-link-type="dfn" href="#site">site</a>. This ensures to some extent that network storage cannot be used to revive <a data-link-type="dfn" href="#site-storage">site storage</a>. This also reduces the amount users need to know about the different ways in
219+
which <a data-link-type="dfn" href="#site">sites</a> can store data.</p>
220+
<p>Credentials storage should be separated as it might contain data the user might not be able to
221+
revive, such as an autogenerated password. Since permissions storage is mostly simple booleans it
222+
too can be separated to avoid inconveniencing the user. Credentials and permissions are also
223+
somewhat easier to understand and differentiate from network storage and <a data-link-type="dfn" href="#site-storage">site storage</a>.</p>
223224
<h3 class="heading settled" data-level="6.1" id="storage-pressure"><span class="secno">6.1. </span><span class="content">Storage Pressure</span><a class="self-link" href="#storage-pressure"></a></h3>
224225
<p>When the user agent notices it comes under storage pressure and it cannot free up sufficient space
225226
by clearing network storage and <a data-link-type="dfn" href="#non-persistent-box">non-persistent boxes</a> within <a data-link-type="dfn" href="#site-storage">site storage</a>, then the

0 commit comments

Comments
 (0)