Skip to content

Commit a928aa9

Browse files
committed
Edits for clarity
Closes #309
1 parent e29a233 commit a928aa9

2 files changed

Lines changed: 7 additions & 3 deletions

File tree

spec/Section 3 -- Type System.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -378,7 +378,9 @@ is correctly produced when using the {CollectFields()} algorithm.
378378

379379
Response serialization formats capable of representing ordered maps should
380380
maintain this ordering. Serialization formats which can only represent unordered
381-
maps should retain this order grammatically (such as JSON).
381+
maps (such as JSON) should retain this order textually. That is, if two fields
382+
`{foo, bar}` were queried in that order, the resulting JSON serialization
383+
should contain `{"foo": "...", "bar": "..."}` in the same order.
382384

383385
Producing a response where fields are represented in the same order in which
384386
they appear in the request improves human readability during debugging and

spec/Section 7 -- Response.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,10 @@ representations of the following four primitives:
2323

2424
Serialization formats which can represent an ordered map should preserve the
2525
order of requested fields as defined by {CollectFields()} in the Execution
26-
section. Serialization formats which can only represent unordered maps should
27-
retain this order grammatically (such as JSON).
26+
section. Serialization formats which can only represent unordered maps
27+
(such as JSON) should retain this order textually. That is, if two fields
28+
`{foo, bar}` were queried in that order, the resulting JSON serialization
29+
should contain `{"foo": "...", "bar": "..."}` in the same order.
2830

2931
Producing a response where fields are represented in the same order in which
3032
they appear in the request improves human readability during debugging and

0 commit comments

Comments
 (0)