This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 7780 - simplify appcache terminology
Summary: simplify appcache terminology
Status: RESOLVED WONTFIX
Alias: None
Product: HTML WG
Classification: Unclassified
Component: pre-LC1 HTML5 spec (editor: Ian Hickson) (show other bugs)
Version: unspecified
Hardware: PC Linux
: P2 normal
Target Milestone: ---
Assignee: Ian 'Hixie' Hickson
QA Contact: HTML WG Bugzilla archive list
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2009-10-01 13:02 UTC by Anne
Modified: 2010-10-04 13:54 UTC (History)
4 users (show)

See Also:


Attachments

Description Anne 2009-10-01 13:02:49 UTC
To keep the mental model of the specification simpler I suggest the following changes:

* explicit section -> cache section
* online whitelist section -> network section
* explicit entries -> cache entries
* online whitelist namespaces -> network namespaces
* online whitelist wildcard flag -> network wildcard flag

This reduces the amount of terminology the document introduces and makes the manifest syntax terminology more consistent with the specification terminology.

This will hopefully make it all a little easier to grasp.
Comment 1 Ian 'Hixie' Hickson 2009-10-18 22:49:00 UTC
The reason I didn't use "cache" as a term is that the whole thing is a cache.
The reason I didn't use "network" as a term is that everything comes from the network.
So I think using those terms in the spec would be confusing.

The reason I used those terms anyway in the syntax is that most authors aren't going to read the spec so for them it won't be as confusing.

I am reluctant to change this now. It's not that confusing.