Pattern needed for describing change history of a creative work (TrustProject request, but broader usecase)

[danbri]

"From Trust Project dialog we would like a pattern for describing errata edits to a document that distinguish errata changes from others, and that is consistent with what we're doing around CreativeWork in general (e.g. version, workExample etc.), and which makes sense for data NewsArticle aggregation usecases such as AMP HTML." (background in schemaorg/schemaorg#1688)

• Can we describe how to use PublicationEvent to give a history of changes/revisions to a creative work?
• Can we show some common practices for indicating via workExample or other properties, how specific versions relate to representations of "the document in general". How does this vary between e.g. books, scholarly articles, versioned releases datasets, news articles?
• For the NewsArticle case, it is important to know which updates include errata and omissions?

/cc @RichardWallis re bibextend

[tfrancart]

In the Legislation extension we rely on workExample to relate specific versions of a law to "that law in general".

Also, something that is not in the proposed Legislation extension but that is present in the ELI ontology is the difference between the notion of "changes" (law A changes law B), implying a legal change, and "corrects", implying only minor typo fixes, not changing the intellectual/legal content. Basically we have this property hierarchy :

changes
  \- amends
  \- repeals
  \- commences
  \- ...
corrects

Similar use-case : we are currently working to model (not using schema.org) the process of drafting legislation, implying the modeling of change Events in the drafted law lifecycle, and the sequence of versions of the drafted law.

My 2 cents.

[davidbarratt]

It would be helpful having a Revision type or something like that. There isn't really a way to represent changes to things. A git commit would be an example of a Revision to SoftwareSourceCode etc.

[davidbarratt]

Or There could be a difference between a Revision and a Diff

• Revision Examples:
  • https://github.com/schemaorg/schemaorg/tree/4702f1dc8149fed9c14cfeca9b9bda4e4fd04d5c
  • https://en.wikipedia.org/w/index.php?title=Schema.org&oldid=941696360
• Diff Examples:
  • schemaorg/schemaorg@4702f1d
  • https://en.wikipedia.org/w/index.php?title=Schema.org&diff=941696360&oldid=937045575

[davidbarratt]

I suppose a Diff consists of two Revision objects and perhaps also describes the difference between them.

[RichardWallis]

See issue #7 for the context of the move from the main Schema.org issue tracker to this repository.