W3C home > Mailing lists > Public > whatwg@whatwg.org > August 2011

[whatwg] [editing] HTML Editing APIs specification ready for implementer feedback

From: Aryeh Gregor <ayg@aryeh.name>
Date: Tue, 2 Aug 2011 17:21:11 -0400
Message-ID: <CAKA+AxkXSTh_Nwp7T4hvoRPxGBUjwN91sbP-X_pe9j9UMSD-SQ@mail.gmail.com>
On Tue, Jul 26, 2011 at 5:26 PM, Aryeh Gregor <Simetrical+w3c at gmail.com> wrote:
> Anyone reviewing the spec should be advised that I put extensive
> rationale in HTML comments. ?If you want to know why the spec says
> what it does, check the HTML source. ?I plan to change this to use
> <details> or such in the near future.

Since the comments were relatively hard to spot, I've rewritten them
to be visible as you read the spec.  There are now tons of "Comments"
buttons floated to the right, which contain lots of rationale and
other commentary.  Some are pretty terse and are reminders to me as
much as anything, others are detailed explanations of the reasons
behind various decisions (some inordinately long, with the "toggle
lists" one being the most egregious).  I probably introduced some
editorial mistakes in the course of converting the comments, but they
should be extremely helpful for review.
Received on Tuesday, 2 August 2011 14:21:11 UTC

This archive was generated by hypermail 2.4.0 : Wednesday, 22 January 2020 16:59:35 UTC