[w3c/DOM-Parsing] Rewrite (PR #88)

My vacation project got a bit out of hand. This contains mostly editorial changes to improve cross-referencing, clarify prose, and make the variable tracking in respec work. It also fixes a few easy bugs at the end. All commits should be self-contained.

I can't commit to taking over maintenance, but this should be helpful in case anyone would step up to do so.
You can view, comment on, or merge this pull request online at:

  https://github.com/w3c/DOM-Parsing/pull/88

-- Commit Summary --

  * Editorial: Fix Respec warnings
  * Editorial: Update the Respec configuration
  * Editorial: Fix minor typos
  * Normative: Don't use 'should'
  * Editorial: Don't use 'may'
  * Editorial: Explicitly depend on the Infra standard
  * Editorial: Remove redundant definitions of namespaces
  * Editorial: Consistently use 'the empty string'
  * Editorial: Fix mis-nested algorithm step in 'XML serializing an Element node'
  * Editorial: Remove code markup for null, true and false
  * Editorial: Mark up 'Recording the namespace' as an algorithm
  * Editorial: Mark up the 'namespace prefix map' steps as algorithms
  * Editorial: Mark up each node type serialization steps as an algorithm
  * Editorial: Mark up the 'Serializing an Element's attributes' steps as algorithms
  * Editorial: Mark up 'generate a prefix' as an algorithm
  * Editorial: Mark up 'XML serialization' as an algorithm
  * Editorial: Remove spurious dfns in 'XML serializing an Element node'
  * Editorial: Use booleans rather than flags
  * Editorial: Remove redundant 'the value of'
  * Editorial: Cross-reference local name concepts rather than localName attributes
  * Editorial: Cross-reference namespace and namespace prefix concepts
  * Editorial: Cross-reference document element concept
  * Editorial: Cross-reference DocumentType concepts
  * Editorial: Cross-reference ProcessingInstruction concepts
  * Editorial: Cross-reference Attr's value concept
  * Editorial: Cross-reference CharacterData's data concept
  * Editorial: Cross-reference DOMException directly
  * Editorial: Cross-reference setAttribute directly
  * Editorial: Cross-reference attributes directly
  * Editorial: Remove unnecessary references to 'tree order'
  * Editorial: Cross-reference the template element directly
  * Editorial: Cross-reference 'HTML document' directly
  * Editorial: Cross-reference 'children' directly
  * Editorial: Cross-reference 'ASCII case-insensitive' directly
  * Editorial: Remove obsolete reference to 'case-sensitive'
  * Editorial: Consistently cross-reference interfaces and interface members
  * Editorial: Remove redundant 'the' or 'this' referring to variables
  * Editorial: Remove unused definition
  * Editorial: Remove obsolete note about Attr/Node inheritance
  * Editorial: Simplify algorithm flow wording
  * Editorial: Consistently use a list for serialization algorithm steps
  * Editorial: Cross-reference 'is empty'
  * Editorial: Redefine namespace prefix map as an ordered map and clarify algorithms
  * Editorial: Clarify the prefix index handling
  * Editorial: Cross-reference 'throw an exception'
  * Editorial: Remove some redundant prose when calling algorithms
  * Editorial: Clarify note about children of the document
  * Editorial: Remove reference to void elements
  * Editorial: Clarify some prose
  * Editorial: Redefine local prefixes map as an ordered map and clarify algorithms
  * Editorial: Drop 'context namespace' definition
  * Editorial: Use explicit substeps for steps that do too much
  * Editorial: Use 'set' instead of 'let' where appropriate
  * Editorial: Mark up HTML elements consistently
  * Editorial: Add type annotations to some variables
  * Editorial: Add and mark up more notes
  * Editorial: Reduce duplication in 'XML serialization of the attributes'
  * Editorial: Clarify signature of 'serializing an attribute value'
  * Editorial: Reduce duplication in 'XML serializing a Text node'
  * Editorial: Add references to some GitHub issues
  * Editorial: Only pass attributes to 'recording the namespace information'
  * Editorial: Clarify 'retrieving a preferred prefix string'
  * Editorial: Update references to unversioned standards
  * Normative: Preserve an attribute's namespace prefix when possible
  * Normative: Restore serialization of CDATASection nodes
  * Normative: Excape tab, LF, CR in attributes

-- File Changes --

    M index.html (1366)
    M respecConfig.js (12)

-- Patch Links --

https://github.com/w3c/DOM-Parsing/pull/88.patch
https://github.com/w3c/DOM-Parsing/pull/88.diff

-- 
Reply to this email directly or view it on GitHub:
https://github.com/w3c/DOM-Parsing/pull/88
You are receiving this because you are subscribed to this thread.

Message ID: <w3c/DOM-Parsing/pull/88@github.com>