A user account is required in order to edit this wiki, but we've had to disable public user registrations due to spam.

To request an account, ask an autoconfirmed user on Chat (such as one of these permanent autoconfirmed members).

Specs/todo: Difference between revisions

From WHATWG Wiki
Jump to navigation Jump to search
(→‎APIs: UI Events spec)
(54 intermediate revisions by 7 users not shown)
Line 1: Line 1:
There are many specifications that need editors. This page lists some of the more important ones. If you want to volunteer to edit one of these specs, contact [email protected] or post on the WHATWG mailing list or say something on the #whatwg IRC channel on Freenode.
There are many specifications that need editors. This page lists some of the more important ones. If you want to volunteer to edit one of these specs, contact [email protected], post on the WHATWG mailing list or say something on [[IRC]].


== How to edit a spec ==
== Platform ==


We have [[How to write a spec|some documentation on how to write a spec]] that could help if you want to help out.
* [https://dvcs.w3.org/hg/editing/raw-file/tip/editing.html HTML Editing APIs]
* multipart/form-data
* SVG
* APNG (other image formats too maybe?)
* [[Wikipedia:Robots.txt|robots.txt]]
* A specification that defines how XML maps to DOM Core. (This could be in DOM Parsing and Serialization or HTML if XML does not get updated.)
* X-Frames-Options (make part of CSP?)
* HTTP (error handling in particular, might become less of an issue if we're successful in removing it in favor of HTTPS)


== Specs to edit ==
== APIs ==


=== DOM ===
* A rewrite of DOM2 Traversal.
* A rewrite of DOM2 Range -- start at http://bitbucket.org/ms2ger/dom-range -- http://html5.org/specs/dom-range.html -- use [[IRC]] for questions
** including much more detail
** including de-facto features, e.g. [https://developer.mozilla.org/en/DOM/range.createContextualFragment createContextualFragment()]
** [http://www.w3.org/Bugs/Public/buglist.cgi?query_format=advanced&short_desc_type=allwordssubstr&short_desc=&product=WebAppsWG&component=DOM+Range&longdesc_type=allwordssubstr&longdesc=&bug_file_loc_type=allwordssubstr&bug_file_loc=&status_whiteboard_type=allwordssubstr&status_whiteboard=&keywords_type=allwords&keywords=&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&emailtype1=substring&email1=&emailtype2=substring&email2=&bug_id_type=anyexact&bug_id=&votes=&chfieldfrom=&chfieldto=Now&chfieldvalue=&cmdtype=doit&order=Last+Changed&field0-0-0=noop&type0-0-0=noop&value0-0-0= Bugs]
* DOM Parsing and Serialization
** This specification should define how XML maps to DOM Core
** This specification should define how to serialize XML
** This specification should define XMLSerializer and DOMParser (see start for DOMParser at http://bitbucket.org/ms2ger/domparser -- use [[IRC]] for questions)
** This specification ideally also defines Document.innerHTML and Element.innerHTML for all types of Document nodes and Element nodes.
* User Interaction Events (onclick, onkeypress, etc).
* User Interaction Events (onclick, onkeypress, etc).
** e.g. need to define somewhere that if you cancel mousedown, an element can't get focus
** e.g. need to define somewhere that if you cancel mousedown, an element can't get focus
** cut/copy/paste events
** setCapture / releaseCapture [http://lists.w3.org/Archives/Public/public-webapps/2008OctDec/0308.html]
* [http://developer.mozilla.org/En/DOM/Window.atob window.atob]
** [http://krijnhoetmer.nl/irc-logs/whatwg/20121128#l-1719 selectstart] (WebKit/IE)
* [http://developer.mozilla.org/En/DOM/Window.btoa window.btoa]
** https://w3c.github.io/uievents/
* An API for cryptography, to generate keys and the like
* Undomanager: http://rniwa.com/editing/undomanager.html and http://rniwa.com/editing/undomanager-usecases.html
* The console.* API. [http://www.w3.org/Bugs/Public/show_bug.cgi?id=10694]
* <del>The console.* API.</del>
** https://console.spec.whatwg.org/
** https://github.com/DeveloperToolsWG/console-object
** http://www.w3.org/Bugs/Public/show_bug.cgi?id=10694
** http://www.w3.org/mid/[email protected]
** http://sideshowbarker.github.com/console-spec/]
* [[DOM XPath]]
* [[DOM XSLTProcessor]]


=== CSS ===
== CSS ==


There are [http://www.w3.org/Style/CSS/current-work many specifications for extending CSS] that are in need of editors. The most important ones are:
There are [http://www.w3.org/Style/CSS/current-work many specifications for extending CSS] that are in need of editors. The most important ones are:
* CSS Animation
* Hit Testing (see http://lists.w3.org/Archives/Public/www-style/2010Aug/0407.html)
* CSS Gradients
* Form control styling (see [https://github.com/domenic/html-as-custom-elements HTML as Custom Elements])
* [http://dev.w3.org/csswg/cssom/ CSSOM]
* Table Layout
** CSSOM needs to define how Link:, <?xml-stylesheet?>, <link rel=stylesheet>, and <style> interact with the fetching algorithm, the event loop, and the parsers from HTML5.
** http://dbaron.org/css/intrinsic/
** CSSOM should have a mechanism for taking elements full-screen
** http://dev.w3.org/csswg/css3-tables-algorithms/Overview.src.htm
** it has been proposed that CSSOM have a mechanism for keeping track of when expensive-to-compute areas of the document (e.g. a canvas) are actually being rendered.
** https://drafts.csswg.org/css-tables-3/
*** Add a pair of events that fire when an element is hidden and unhidden
* Replaced Content
*** Add a pair of events that fire when an element is scrolled into and out of the view
** http://dev.w3.org/csswg/css3-content/ (Do we still want this or is the component model sufficient?)
* <?xml-stylesheet?> could do with a rewrite for integration with CSSOM; do 'load' and 'error' events fire on it?
* an imperative model of box-tree construction


=== Registries ===
== Registries ==


Currently, the state of registries on the Web (and indeed for the Internet in general) is a disaster. At a minimum, the following registries need dramatically updating:
Currently, the state of registries on the Web (and indeed for the Internet in general) is a disaster. At a minimum, the following registries need dramatically updating:


* Encodings: [[Web Encodings]]
* MIME types
* MIME types
* Schemes
* URL schemes


It's possible that the right solution is to change approach altogether (e.g. moving more to a wiki model of registries).
It's possible that the right solution is to change approach altogether (e.g. moving more to a wiki model of registries).
Line 52: Line 53:
See also: [[Registries]]
See also: [[Registries]]


=== MISC ===
== Miscellaneous ==
* an API to do syntax highlighting on  &lt;textarea>, &lt;pre>, and contenteditable sections would be highly popular with Web developers (ack Ryan Johnson). (This would probably best be done as some sort of output filter at the CSS level, rather than anything HTML-specific.)
* an API to do syntax highlighting on  &lt;textarea>, &lt;pre>, and contenteditable sections would be highly popular with Web developers (ack Ryan Johnson). (This would probably best be done as some sort of output filter at the CSS level, rather than anything HTML-specific.)
* JS changes: [[Web ECMAScript]]
* Animated [[GIF]]s need a spec that, in particular, specifies how to handle timings (not all browsers honor all values, so we should specify what needs to be honored exactly)
* Animated GIFs need a spec that, in particular, specifies how to handle timings (not all browsers honour all values, so we should specify what needs to be honoured exactly)
* Client-side HTTP implementation requirements specification ("option 3" in http://www.w3.org/mid/[email protected])
* Client-side HTTP implementation requirements specification ("option 3" in http://www.w3.org/mid/[email protected])
* <del>innerText and</del> outerText, if browsers don't remove them entirely
** http://perfectionkills.com/the-poor-misunderstood-innerText/
** https://github.com/whatwg/html/issues/465
* data URLs
** https://simonsapin.github.io/data-urls/


== See also ==
== Other stuff ==


* http://lists.w3.org/Archives/Public/public-html/2008Oct/0127.html (a description of some sections that needed editing in 2008 and how much work they would be)
http://lists.w3.org/Archives/Public/public-html/2008Oct/0127.html has a description of some sections that needed editing in 2008 and how much work they would be.
 
== Other stuff ==


Some notes from the HTML5 spec about things that need doing:
Some notes from the HTML5 spec about things that need doing:


* support access Array element via () instead of [] (IEism) https://bugzilla.mozilla.org/show_bug.cgi?id=289876
* Need to say that NodeList's items are enumerable, so that...  for (var x in myNodeList) { }  ...works. (ack Dethe Elza)
* a way to show icons for file types e.g. http://www.gadgetopia.com/2004/05/04/FileIconTag.html (this should probably be a function for the 'content', 'background-image' and 'list-style-image' properties in CSS)
* a way to show icons for file types e.g. http://www.gadgetopia.com/2004/05/04/FileIconTag.html (this should probably be a function for the 'content', 'background-image' and 'list-style-image' properties in CSS)
** Maybe something like moz-icon://? http://lists.w3.org/Archives/Public/public-webapps/2010JanMar/0255.html, http://draft-icon-uri-scheme.googlecode.com/hg/draft-lafayette-icon-uri-scheme-00.html
** Maybe something like moz-icon://? http://lists.w3.org/Archives/Public/public-webapps/2010JanMar/0255.html, http://draft-icon-uri-scheme.googlecode.com/hg/draft-lafayette-icon-uri-scheme-00.html
[[Category:Spec coordination|*]]
[[Category:Specification editing]]

Revision as of 09:31, 15 March 2016

There are many specifications that need editors. This page lists some of the more important ones. If you want to volunteer to edit one of these specs, contact [email protected], post on the WHATWG mailing list or say something on IRC.

Platform

  • HTML Editing APIs
  • multipart/form-data
  • SVG
  • APNG (other image formats too maybe?)
  • robots.txt
  • A specification that defines how XML maps to DOM Core. (This could be in DOM Parsing and Serialization or HTML if XML does not get updated.)
  • X-Frames-Options (make part of CSP?)
  • HTTP (error handling in particular, might become less of an issue if we're successful in removing it in favor of HTTPS)

APIs

CSS

There are many specifications for extending CSS that are in need of editors. The most important ones are:

Registries

Currently, the state of registries on the Web (and indeed for the Internet in general) is a disaster. At a minimum, the following registries need dramatically updating:

  • MIME types
  • URL schemes

It's possible that the right solution is to change approach altogether (e.g. moving more to a wiki model of registries).

See also: Registries

Miscellaneous

Other stuff

http://lists.w3.org/Archives/Public/public-html/2008Oct/0127.html has a description of some sections that needed editing in 2008 and how much work they would be.

Some notes from the HTML5 spec about things that need doing: