Lee editorial updates

Author: leebyron

spec/Appendix A -- Notation Conventions.md

@@ -219,35 +219,32 @@ implementations.
 
 ## Data Collections
 
-A data collection is a finite, iterable aggregation of elements whose iteration
-order is not necessarily stable. This specification describes the semantic
-properties of data collections using types like "list", "set" and "map". These
-describe observable data collections, such as the result of applying a grammar
-and the inputs and outputs of algorithms. They also describe unobservable data
-collections such as temporary data internal to an algorithm. Each data
-collection type defines the operations available, and whether values are unique
-or ordered.
+Algorithms within this specification refer to specific data collection types.
+Temporary data internal to an algorithm serves to best describe expected
+behavior. Data observed from a service adhering to this specification must
+behave according to the uniqueness and iteration order expectations of those
+data types.
 
 **List**
 
-:: The term _list_ describes a sequence of zero or more values, which may
-contain duplicates. Currently, all lists in this specification are ordered, but
-for clarity the term "ordered list" may be used when an order is semantically
-important.
+:: The term _list_ describes an ordered collection of values which may contain
+duplicates. A value added to a list is ordered after existing values.
 
 **Set**
 
-:: The term _set_ describes a collection of zero or more values, which may not
-contain duplicates. Each value is considered a "member" of the set. A set is
-unordered unless explicitly stated otherwise (as an "ordered set"). For clarity,
-the term "unordered set" may be used when the lack of an order is semantically
-important.
+:: The term _set_ describes a collection of values which must not contain
+duplicates.
+
+:: The term _ordered set_ describes a set which has a defined order. A value
+added to an ordered set, which does not already contain that value, is ordered
+after existing values.
 
 **Map**
 
-:: The term _map_ describes a collection where each element is a pair (called an
-"entry") consisting of a key and a value. Keys are unique: no two entries with
-the same key may exist in the same map, but values may repeat. A map is
-unordered unless explicitly stated otherwise (as an "ordered map"). For clarity,
-the term "unordered map" may be used when the lack of an order is semantically
-important.
+:: The term _map_ describes a collection of entries, each of which has a key and
+value. Entry keys are unique, no two entries have the same key. Each map entry
+can be directly referenced by its key.
+
+:: The term _ordered map_ describes a map which has a defined order. An entry
+added to an ordered map, which does not have an entry with that key, is ordered
+after existing values.

spec/GraphQL.md

@@ -88,18 +88,15 @@ algorithm step (e.g. "Let completedResult be the result of calling
 CompleteValue()") is to be interpreted as having at least the same level of
 requirement as the algorithm containing that step.
 
-Conformance requirements expressed as algorithms can be fulfilled by an
-implementation of this specification in any way as long as the perceived result
-is equivalent. Algorithms described in this document are written to be easy to
-understand. Implementers are encouraged to include equivalent but optimized
-implementations. Similarly, data collections such as _list_, _set_ and _map_
-also introduce conformance requirements. Implementers are free to use
-alternative data collections as long as the perceived result remains equivalent.
+Conformance requirements expressed as algorithms and data collections can be
+fulfilled by an implementation of this specification in any way as long as the
+perceived result is equivalent. Algorithms described in this document are
+written to be easy to understand. Implementers are encouraged to include
+equivalent but optimized implementations.
 
 See [Appendix A](#sec-Appendix-Notation-Conventions) for more details about the
-definition of algorithms and other notational conventions used in this document,
-and [Appendix A: Data Collections](#sec-Data-Collections) for specifics of data
-collections and their ordering.
+definition of algorithms, data collections, and other notational conventions
+used in this document.
 
 **Non-Normative Portions**