Feedback on "Offline Web Applications" (Editor's Draft 17 November 2007)

Hi,

below is some feedback on "Offline Web Applications" (Editor's Draft 17 
November 2007) (<http://dev.w3.org/html5/offline-webapps/>).

Summary: if the intent of this is to make people aware of the presence 
of these new things in HTML5, it's working. However, in it's current 
state it really requires the reader to go to the real spec to understand 
what's going on -- that may be ok, but in this case it would be helpful 
if it could point directly to the section of HTML5 containing the full 
details.

Content:

2. SQL -- Not being familiar with what is being defined, I found the 
example a bit confusing. If this is meant to be an introduction, I think 
it would make sense to (1) show the DB creation first and (2) add a few 
sentences about how the API exactly looks like. So what elements does 
openDatabase() take(), why does db.transaction take a function argument, 
what exactly does the executeSQL function expect parameter-wise?

3. Offline Application Caching APIs -- seems the spec defines a new text 
format for defining the application caching. Is there a MIME type being 
defined? Any grammar for the format? Turns out this is defined in 
<http://www.w3.org/html/wg/html5/#manifests>, so it's probably fine to 
leave it out here. However, *what* is defined over there ("Note: This is 
a willful double violation of RFC2046.") makes me nervous. Not sure why 
this isn't simply an XML format; instead of defining yet another special 
text format with (IMHO) quite obscure parsing rules (CR only as line 
delimiter???)

3. Offline Application Caching APIs -- not sure that using "server.cgi" 
as a name is a good idea over here; my understanding was that Cool URIs 
Do Not Change, thus encoding some technology-specific extension into an 
URI generally is not a good idea. Suggest to simply use something like 
"events".

Editorial:

- The Javascript examples do not terminate statements with a semicolon. 
My understanding is that although it's legal, it's discouraged (see 
<http://www.jslint.com/lint.html>). Minimally, it's confusing to read 
for people who have grown up with C and Java.

- "...that takes up one mebibyte of storage." -- Typo?



Best regards, Julian

Received on Sunday, 18 November 2007 18:54:53 UTC