ISSUE-94: Split Web Application Core and UA specific elements into separate spec

webcoresplit

Split Web Application Core and UA specific elements into separate spec

State:
CLOSED
Product:
HTML 5 spec
Raised by:
Shelley Powers
Opened on:
2010-01-09
Description:
Currently the HTML5 specification contains a section, Section 5, devoted
primarily to user agents like browsers. The section notes that though it is focused on browsers, requirements in the section apply to all user agents, not just browsers, unless otherwise noted.

Though browsers are a major user agent for HTML/XHTML, they are not the only
user agents. In particular, ebook technology is dependent on XHTML, and forms a
completely different class of user agents than browsers. In addition, there are
email applications that exist outside of browsers that also make use of
HTML/XHTML, in addition to some word processing software.

Though the section does provide a good reverse engineering of browser
technology, most of the section has little to do with HTML, in general. In
addition, it also has little to do with the Document Object Model (DOM), which is based on the HTML syntax, not objects implemented by various browsers.

Including this section greatly extends the HTML5 specification beyond the
charter, and beyond boundaries one can reasonably expect from an effort focused
on HTML, both the XML serialization and non-XML serialization, and the DOM. In
addition, by focusing the specification primarily towards browsers, we are
limiting the usefulness of the HTML specification for other uses, both now, and
in the future. Though one could say that the use of XHTML by eBooks is incidental to the development of a web-based language, that the ePub standard evolved from XHTML is a demonstration of the quality of a well-defined spec: new uses can evolve.

Encapsulating everything relevant to browsers in the HTML spec is counter to good technology practices. Consider how a programmer creates an application:

They look for opportunities to create reusable objects, which they then use to create any number of applications, not just one. We should follow the same philosophy when creating a new version of HTML by restricting our effort to a new version of HTML, its serialization in XML, and the DOM. This will include new elements, such as video, which may not be useful for all variations of user agents, but the concept behind the new elements still fits within our perceptions of what we would reasonably expect from an HTML specification.

Simplifying the HTML5 specification in this way will greatly increase its
usability by many user agents, not just browsers. A standardized UA or Browser Object Model, or Web Applications Core can then reference HTML, true, but so can other specifications, such as ePub (for eBooks) and so on.

In addition, browser technology expands at a faster pace than that for the
underlying HTML specification. By separating Section 5 out, the work can then be
incorporated into a new effort that can be focused specifically on the class of
user agents, which includes browser. This new effort won't then be dependent on the same release cycle as HTML.

Separating the section out doesn't mean ripping the section out without checking cross-references. Care would need to be taken to ensure best effort, and there should be an additional effort to ensure a group is ready to absorb the newly separated out material and move it forward to FPWD and beyond.

Another advantage to separating the material out is the fact that the work could be accessible by other specifications, and not just HTML. For instance, most of the web application core would also be applicable to SVG, as well as HTML/XHTML.

Additionally, separating the material out should prevent confusion about the location of the material in the future. The browser object model, as it has been informally termed, has been around almost as long as HTML, but has existed separate from HTML. To suddenly combine the two will cause confusion about where to find the pertinent information about the specification.

Lastly, splitting this section out helps to correct some of the problems with the existing HTML spec, which frequently mixes up the audience in the writing. Throughout the spec, we find that one sentence is directed at implementor, the next at authoring tools, the third at web page authors, the fourth at web developers--this type of haphazard mixing of audiences will, again, make the HTML5 specification extremely difficult to follow, and confusing. Anything we can do to improve the readability of the spec should be encouraged.

Change Proposal:
http://www.w3.org/html/wg/wiki/ChangeProposals/webcoresplit

HTML5-SPEC-SECTIONS [browsers]
Related Actions Items:
No related actions
Related emails:
  1. Minutes of HTML WG meeting, Apr 15 2010 (from Paul.Cotton@microsoft.com on 2010-04-19)
  2. {agenda} HTML WG telcon 2010-04-15: Action items, issues, decision policy, task forces, TPAC (from rubys@intertwingly.net on 2010-04-14)
  3. Minutes of HTML WG meeting, Apr 8 2010 (from Paul.Cotton@microsoft.com on 2010-04-08)
  4. {agenda} HTML WG telcon 2010-04-08: calls for proposals, issue status (from mjs@apple.com on 2010-04-07)
  5. Re: ISSUE-94 Change Proposal (from mjs@apple.com on 2010-04-06)
  6. [minutes] 2010-04-01 HTML Teleconference (from rubys@intertwingly.net on 2010-04-01)
  7. Re: Change proposals uploaded to Wiki - URLs, suggestions on Issue 92 table (from mjs@apple.com on 2010-03-31)
  8. Re: ISSUE-94 Change Proposal (from rubys@intertwingly.net on 2010-03-31)
  9. Re: ISSUE-94 Change Proposal (from mjs@apple.com on 2010-03-31)
  10. Re: ISSUE-94 Change Proposal (from jonas@sicking.cc on 2010-03-31)
  11. Re: ISSUE-94 Change Proposal (from ian@hixie.ch on 2010-03-31)
  12. Re: ISSUE-94 Change Proposal (from shelley.just@gmail.com on 2010-03-31)
  13. Re: ISSUE-94 Change Proposal (from jonas@sicking.cc on 2010-03-31)
  14. Re: ISSUE-94 Change Proposal (from shelley.just@gmail.com on 2010-03-31)
  15. Re: ISSUE-94 Change Proposal (from jonas@sicking.cc on 2010-03-31)
  16. ISSUE-94 Change Proposal (from shelley.just@gmail.com on 2010-03-31)
  17. Re: {agenda} HTML WG telcon 2010-04-01: action items, decision policy update, issue status (from shelley.just@gmail.com on 2010-03-30)
  18. {agenda} HTML WG telcon 2010-04-01: action items, decision policy update, issue status (from Paul.Cotton@microsoft.com on 2010-03-30)
  19. {agenda} HTML WG telcon 2010-04-01: action items, decision policy update, issue status (from Paul.Cotton@microsoft.com on 2010-03-30)
  20. [minutes] 20100325 HTML teleconference (from plh@w3.org on 2010-03-30)
  21. Re: {agenda} HTML WG telcon 2010-03-25: decision policy, issue status, updates from meetings, task force reports (from mjs@apple.com on 2010-03-24)
  22. {agenda} HTML WG telcon 2010-03-25: decision policy, issue status, updates from meetings, task force reports (from rubys@intertwingly.net on 2010-03-24)
  23. [Bug 7386] SharedWorkerGlobalScope (from bugzilla@wiggum.w3.org on 2010-03-14)
  24. Re: Breakdown of issues (from rubys@intertwingly.net on 2010-03-12)
  25. Breakdown of issues (from mjs@apple.com on 2010-03-12)
  26. ISSUE-94 and significant editing changes to specification since issue was created (from shelleypowers@burningbird.net on 2010-03-05)
  27. Re: ISSUE-93 details - Call for Change Proposals (from mjs@apple.com on 2010-01-27)
  28. {agenda} HTML WG telcon 2010-01-28: (from mjs@apple.com on 2010-01-27)
  29. ISSUE-94 webcoresplit - Call for Proposals (from Paul.Cotton@microsoft.com on 2010-01-26)
  30. Re: {agenda} HTML WG telcon 2010-01-14: AIs, CfC/CfPs, TFs, plus: heartbeat docs (from shelley.just@gmail.com on 2010-01-13)
  31. {agenda} HTML WG telcon 2010-01-14: AIs, CfC/CfPs, TFs, plus: heartbeat docs (from rubys@intertwingly.net on 2010-01-13)
  32. [Bug 7386] SharedWorkerGlobalScope (from bugzilla@wiggum.w3.org on 2010-01-11)
  33. Re: New split-out drafts vs. modular design (from shelley.just@gmail.com on 2010-01-10)
  34. Re: New split-out drafts vs. modular design (from jonas@sicking.cc on 2010-01-09)
  35. [Bug 8365] Remove the Web Browsers Section 5 (from bugzilla@wiggum.w3.org on 2010-01-09)
  36. ISSUE-94 (webcoresplit): Split Web Application Core and UA specific elements into separate spec [HTML 5 spec] (from sysbot+tracker@w3.org on 2010-01-09)

Related notes:

[paulc]: webcoresplit

15 Apr 2010, 16:15:57

[rubys]: closed without prejudice

15 Apr 2010, 16:17:17

Change Proposal:
http://www.w3.org/html/wg/wiki/ChangeProposals/webcoresplit

Laura Carlson, 10 May 2010, 13:07:00

Display change log ATOM feed


Maciej Stachowiak <mjs@apple.com>, Sam Ruby <rubys@intertwingly.net>, Chairs, Michael[tm] Smith <mike@w3.org>, Staff Contact
Tracker: documentation, (configuration for this group), originally developed by Dean Jackson, is developed and maintained by the Systems Team <w3t-sys@w3.org>.
$Id: 94.html,v 1.1 2019/10/11 08:04:59 carcone Exp $