This spec (as well as JSON-LD 1.1 Syntax and JSON-LD 1.1 Framing) has an option, in §1.1 How to Read this Document, to highlight all the changes that were made compared to JSON-LD 1.0.
I would argue that we should drop this. First, because it is quite tedious to add the class change to any part of the document we modify (or any part we add). Second, because it would be even more tedious if we wanted to show instead (or in addition) the changes between 1.1 and 1.2, and why shouldn't we if we go down that path?
We already have a number of Change Log sections, I think that should be enough.
This spec (as well as JSON-LD 1.1 Syntax and JSON-LD 1.1 Framing) has an option, in §1.1 How to Read this Document, to highlight all the changes that were made compared to JSON-LD 1.0.
I would argue that we should drop this. First, because it is quite tedious to add the class
changeto any part of the document we modify (or any part we add). Second, because it would be even more tedious if we wanted to show instead (or in addition) the changes between 1.1 and 1.2, and why shouldn't we if we go down that path?We already have a number of Change Log sections, I think that should be enough.