ISSUE-124: Remove RFC2119 keywords from examples

reword examples

Remove RFC2119 keywords from examples

State:
CLOSED
Product:
HISTORICAL: DOM3 Events [All Bugs and Issues use Bugzilla: http://tinyurl.com/Bugs-DOM3Events]
Raised by:
Doug Schepers
Opened on:
2010-09-15
Description:
Simon Pieters <http://lists.w3.org/Archives/Public/www-dom/2010JulSep/0125.html>:
[[

For example, the activation behavior of an HTML or SVG <a> element shall
...

For example, if the Event.bubbles attribute is set to false, the bubble
phase shall be skipped, and if Event.stopPropagation() has been called
prior to the dispatch, all phases must be skipped.

RFC2119 keywords in examples is bad style. Please replace RFC2119 keywords
in non-normative sections and examples with other words.

There are three sections (1.2, 1.3 and 6.2.6) that are marked as
normative, and they all use different style. All sections that are
normative should be marked as such, or all sections that are non-normative
should be marked as such, or both.
]]
Related Actions Items:
No related actions
Related emails:
  1. Re: ISSUE-124: Futures / Order of parameters (was: Re: Request for JSON-LD API review) (from jackalmage@gmail.com on 2013-04-17)
  2. Re: ISSUE-124: Futures / Order of parameters (was: Re: Request for JSON-LD API review) (from jackalmage@gmail.com on 2013-04-17)
  3. Re: ISSUE-124: Futures / Order of parameters (was: Re: Request for JSON-LD API review) (from jackalmage@gmail.com on 2013-04-17)
  4. RDF-ISSUE-125 Futures vs. callbacks (was: Re: Request for JSON-LD API review) (from markus.lanthaler@gmx.net on 2013-04-17)
  5. ISSUE-124: Futures / Order of parameters (was: Re: Request for JSON-LD API review) (from msporny@digitalbazaar.com on 2013-04-17)
  6. Re: ISSUE-124 (reword examples): Remove RFC2119 keywords from examples [DOM3 Events] (from Jacob.Rossi@microsoft.com on 2011-08-12)
  7. ISSUE-124 (reword examples): Remove RFC2119 keywords from examples [DOM3 Events] (from sysbot+tracker@w3.org on 2010-09-15)

Related notes:

LAST CALL

Doug Schepers, 15 Sep 2010, 17:52:15

LAST CALL

Doug Schepers, 15 Sep 2010, 18:07:19

Revision 1.180

Jacob Rossi, 6 May 2011, 02:12:58

Display change log ATOM feed


Chair, 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: 124.html,v 1.1 2016/01/25 10:26:14 carine Exp $