Review 5.2.0
dotnet add package Review --version 5.2.0
NuGet\Install-Package Review -Version 5.2.0
<PackageReference Include="Review" Version="5.2.0" />
paket add Review --version 5.2.0
#r "nuget: Review, 5.2.0"
// Install Review as a Cake Addin #addin nuget:?package=Review&version=5.2.0 // Install Review as a Cake Tool #tool nuget:?package=Review&version=5.2.0
Revisions
Data model and examples for representing revisions and tracking information in rdf.
This is an adaptation of the records format from https://github.com/equinor/records
Introduction
There are three main types of objects, the actual engineering Content, the Document, and the Revision.
Content
This is the actual data that users want to transmit and read. In many use cases this is data created from engineering applications or even by hand. The data can be used by the format described here if
- It is in Rdf (Note that many tabular formats can easily be translated to rdf)
- It is plain triples, no named graphs. (It is possible to use named graphs, but then they must match up with the named graphs used as records)
- There are Iris that identify the objects the data is about, and these Iris do not change over time. (This is usually the case when using Rdf, but it is not a technical requirement in Rdf, therefore stating here.)
Non-rdf documents should be represented as attachments to the Rdf.
Revision
Revisions have information about when and how data changed. For example, if you add a new part to a machine or change the weight of an existing part, you need to make a new revision. The revision represents a specific version of data, frozen at some moment in time. It is meant to represent the existing revision concept and should support review processes.
The object property "rev:containsRecord" relates the revision to the records that contain the revision content.
The triples of this relation must be in the record describing the revision. That is, this relation should not be used in any other records than the one describing the revision.
If the revision is delivered as one big record with document, revision and data, this relation is unnecessary.
We recommend putting the revision in a separate record for ease of manual reading during investigation.
Document
The work processes we support also need a navigation path into the data called "document". The document does not represent a version or concrete doument, it rather represents the collection of information, evolving over time. Any information that does not change over time, could be put as properties on the document, in stead of on each revision.
Examples
Repository map
schema/: Ontologies and Schema
schema/revision.ttl and schema/revision.shacl: Generic format for sending revisions of data
schema/comment.ttl and schema/comment.shacl: Extension of the revision format for sending comments and reviews
schema/tie.ttl : Reference data necessary for the mel use case/example below
doc/: Documentation and example
doc/mel-revision-example.md A full example of revision and record usage for the Mel use case. Should be easy to transfer to other use cases
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
-
net8.0
- ClosedXml (>= 0.104.1)
- dotNetRdf (>= 3.3.0)
- IriTools (>= 2.2.0)
- System.IO.Packaging (>= 8.0.1)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
Version | Downloads | Last updated |
---|---|---|
5.2.0 | 879 | 10/18/2024 |
5.1.1 | 118 | 10/18/2024 |
5.1.0 | 1,690 | 8/12/2024 |
5.0.0 | 245 | 8/6/2024 |
4.1.0 | 308 | 7/3/2024 |
4.0.5 | 604 | 5/23/2024 |
4.0.4 | 99 | 5/23/2024 |
4.0.3 | 126 | 5/23/2024 |
4.0.2 | 112 | 5/22/2024 |
4.0.1 | 200 | 5/22/2024 |
4.0.0 | 127 | 5/21/2024 |
3.1.0 | 303 | 5/6/2024 |
3.0.0 | 123 | 4/29/2024 |
2.1.0 | 296 | 4/22/2024 |
2.0.4 | 213 | 4/10/2024 |
2.0.3 | 214 | 3/21/2024 |
2.0.2 | 147 | 3/21/2024 |
2.0.1 | 482 | 3/14/2024 |
2.0.0 | 184 | 3/13/2024 |
1.0.5 | 208 | 2/29/2024 |