<div dir="ltr"><div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">
<h4 style="font-weight: normal;"><span class="secno">Hello all,</span></h4>
<h4 style="font-weight: normal;"><span class="secno">I have many comments on the Offline Web Applications 
corner of the HTML5 spec. This is the first round of comments you&#39;ll see coming 
from me. This one is mostly top-level comments.<br></span></h4>
<h4><span class="secno"></span><span class="secno"></span><span class="secno">5.7.2 
</span>Application caches</h4></span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">I found the terminology used to describe the contents of 
the cache&nbsp;sometimes contradictory and confusing, and it doesn&#39;t correspond 
directly with the terminology used in the manifest file syntax. FWIW, some word 
smithing and reconciling the differences could add clarity to the 
spec.</span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"><strong>
cached resource</strong></span></font></font><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"><strong> categories</strong></span></font></font></div>

<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">&nbsp;&nbsp;</span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* implicit category</span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">This categorization applies to html docs which 
explicitly contain a reference to the manifest file via the &#39;manifest&#39; attribute 
of their &lt;html&gt; tag. I understand they are not necessarily&nbsp;explicitly 
listed in the manifest file, but they&nbsp;may also be explicitly listed.&nbsp;The&nbsp;end 
result is that a resource&nbsp;can be categorized as both&nbsp;&#39;implicit&#39; and &#39;explicit&#39;. 
This is confusing. I&#39;d vote to have a&nbsp;different name for clarity sake... some 
ideas... &#39;toplevel&#39;, &#39;manifest referencing&#39;, &#39;native&#39; (an awkward&nbsp;play on 
foreign).</span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* manifest category</span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">Perfect.</span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">*&nbsp;explicit category</span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">Ok provided &#39;implicit&#39; is renamed.</span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">*&nbsp;fallback category</span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">The term &#39;fallback&#39; refers to the prescribed use of 
these resources for the opportunistic-caching namespace in particular. As part 
of pulling apart namespaces vs how to handle hits within a namespace, I&#39;d vote 
to change the name for this category... some ideas... &#39;namespace-handler&#39;.&nbsp; I&#39;ll 
say more more to say about different types of &#39;namespaces&#39; 
below.</span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* opportunistcally cached category</span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">A&nbsp;mouthful, but ok. Another possibility is 
&#39;auto-cached&#39; which would work well with the&nbsp;&#39;manually-cached&#39; terminology 
below.</span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* dynamic category</span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">I&#39;d like to reserve the term &#39;dynamic&#39; for a different 
use of that term (more on that in a moment).&nbsp; Some name possibilites for this 
category... &#39;manually-cached&#39; or &#39;script-added&#39; or 
&#39;programatically-added&#39;.</span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"><span class="039082923-30072008"><strong>&nbsp;flavors of namespaces</strong></span></span></font></font></div>

<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"><span class="039082923-30072008"></span></span></font>&nbsp;</font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"><span class="039082923-30072008">
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* online whitelist</span></font></div>

<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">As mentioned in previous messages, this would need to 
be some form of namespacing or filtering to be useful. A better term for this 
might be &#39;bypass&#39; since with respect to the appcache, hits here bypass the 
cache. Its not clear if path prefix matching is the best option for filtering 
out request that should bypass the cache. In working with app developers using 
Gears, the idea of specifying a particular query argument to filter on in 
addition to a path prefix has come up.<a href="http://server/pathprefix"> http://server/pathprefix</a>&nbsp;&nbsp;&nbsp;+&nbsp; 
&amp;bypassAppCache</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</div></span></span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"><span class="039082923-30072008">* opportunistic caching 
namespaces</span></span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"><span class="039082923-30072008">A mouthful but ok. 
Whatever terminology used for the category of resulting entries should be used 
here... perhaps&nbsp;&#39;auto-caching namespace&#39;.</span></span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* fallback namespace [factored out of 
opportunistic-caching]</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">This form of namespace is addressed by the spec at 
present, but is co-mingled with the auto-caching feature. This is a proposal to 
detangle them from one another. The basic idea is to load the resource as usual, 
and only upon failure fallback to a cached&nbsp;&#39;namespace-handler&#39;... no 
auto-caching involved.</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</div></span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* intercept namespaces [new]</span></font></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">This form of namespace is not in the spec at present. 
This is a proposal to add it.&nbsp;It is a heavily used feature of the Gears 
LocalServer. The basic idea is to intercept requests into this namespace and 
satisfy them with a cached&nbsp;&#39;namespace-handler&#39;&nbsp; without consulting the server. 
</span></font></font></div>

<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"><strong>summary of the above change 
requests</strong></span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">Cached resource categories (just name 
changes):</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* toplevel - pages which &lt;html 
manifest=&#39;manifesturlforthisappcache&#39;&gt;</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* manifest - the manifest file</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* explicit - explicitly listed in the manifest 
file</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* namespace-handler - resource which is&nbsp;utilized by a 
name-space</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* auto-cached - resources that have been cached via the 
auto-cache namespace</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* manually-cached - resources that have been cached via 
a javascript call to appCache.add()</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">Namespaces (name changes, refactored things a bit, and 
introduced the &#39;intercept&#39; namespace)</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* bypass - bypasses&nbsp;further lookup within the appcache 
and&nbsp;resorts to&nbsp;the usual&nbsp;resource loading</span></font></div>* intercept - 
doesn&#39;t hit server, serves a cached namespace-handler 
resource</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* autocache - hits server, caches successful response 
for future use, on server errors&nbsp;serves a cached namespace-handler 
resource</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* fallback - hits server, does&nbsp;NOT cache successful 
responses, on server errors serves a cached namespace-handler 
resource</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">Manifest file section headers:</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* BYPASS: list of url 
[namespaces/filters]</span></font></div>* CACHE: list of exact 
[urls]</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* INTERCEPT: list of [urlnamespaces, namespace-handler 
url]</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* AUTOCACHE: list of [urlnamespaces, namespace-handler 
url]</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* FALLBACK: : list of [urlnamespaces, namespace-handler 
url]</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"><strong>Scriptlets - or dynamic namespace-handlers [new 
idea]</strong></span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">Something we wrestled with in the process of putting 
together the Gears LocalServer was the distinction between</span></font><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">&nbsp;intercepting requests for urls</span></font><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">&nbsp;and 
identifying the appropiate cached resource for that request. We ended up with a 
declarative manifest file, similar to but different from what is contained in 
this spec. This wasn&#39;t an altogether satisfying answer. The expressiveness of 
the language to match/filter requested urls is limited in Gears and this spec 
shares that same characterization. </span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">Something else we&#39;ve wrestled with in Gears was having 
to do awkward redesigns in corners of a web application in order to &#39;take it 
offline&#39;, single-sign-on for example. In general, anywhere an application relies 
on HTTP features more than HTML to&nbsp;influence navigation or conditional resource 
loading,&nbsp;it&#39;s difficult to address with a static cache.</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">So&nbsp;I&#39;d like to propose extending this spec to 
incorporate &#39;dynamically generated responses&#39;. I think this capability fits into 
this corner of the HTML5 spec because this is most directly useful in the 
&quot;Offline Web Application&quot; scenario. The basic idea is to execute application 
code (script) to produce responses to intercepted resource loads.&nbsp;The 
application code is executed in the background and can formulate a&nbsp;response 
asynchronously.</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">Some handwaving where this could hang off of this 
spec</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* Modify namespace-handlers entries to&nbsp;have an 
attitional attribute to indicate that they are to be executed rather than 
returned</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">And some handwaving at what a scriptlet can 
do...</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* Can read the request headers and POST 
body</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* Can set response status code and headers 
(redirects)</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* Can generate a textual response 
body</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* Can designate a non-executable cached resource to be 
returned in response</span></font></div><span class="039082923-30072008"> 
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* Can decide to &#39;bypass&#39; handling of a request and 
defer to the usual resource loading</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* Can decide to perform the usual resource loading, 
but&nbsp;to have&nbsp;the response added&nbsp;to the appCache</span></font></div></span>* Can 
access HTML5Database APIs<br></span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">* Can utlize XmlHttpRequest to communicate with a 
server</span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">This&nbsp;would&nbsp;obviously be&nbsp;significant addition to the 
spec, but&nbsp;i&nbsp;do&nbsp;think this is worth consideration in the context of &#39;offline 
applications&#39;. Based on observations of app developers wrestling with Gears, 
there have been several pain points. The HTML5ApplicationCache addresses one of them with&nbsp;per-application caches. This addition would address 
the second of them.&nbsp; (Another pain point has been application deployment).<br></span></font></div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008"></span></font>&nbsp;</div>
<div><font color="#800000" size="2" face="Trebuchet MS"><span class="039082923-30072008">Am interested in seeing what others 
think of an addition along these lines.<br></span></font></div></span></font></font></div></div>