Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Describing the "Release Type" #1289

Closed
riannella opened this issue Jan 15, 2021 · 8 comments
Closed

Describing the "Release Type" #1289

riannella opened this issue Jan 15, 2021 · 8 comments
Labels
dcat feedback Issues stemming from external feedback to the WG requirement versioning
Milestone

Comments

@riannella
Copy link

Stakeholders

Aviation industry
Healthcare industry

Problem statement

The need to describe the "release type" of a dataset, such as "baseline" or "full", "snapshot" and "delta" (etc)

Links

Aviation: http://portal.opengeospatial.org/files/?artifact_id=40502
Healthcare: https://www.digitalhealth.gov.au/newsroom/product-releases/snomed-ct-au-and-australian-medicines-terminology-january-2020-release

Requirements

Related use cases

Potentially related to the Dataset Series requirement

Comments

I am not sure if "release type" is the most appropriate property description (maybe better ways...)


@riccardoAlbertoni riccardoAlbertoni added this to the DCAT3 2PWD milestone Jan 15, 2021
@andrea-perego andrea-perego added versioning feedback Issues stemming from external feedback to the WG labels Feb 19, 2021
@andrea-perego
Copy link
Contributor

@riannella , thanks for contributing this use case.

The current DCAT3 ED includes two sections describing possibly related aspects:

  1. How to specify the version delta with a textual description: https://w3c.github.io/dxwg/dcat/#version-info
  2. How to specify the "status" of a resource in its life-cycle: https://w3c.github.io/dxwg/dcat/#life-cycle

About point (1), based on the documents you cite, I guess that with "delta" you rather mean a version including only what has been added, or a diff. Should this be the case, your requirement may be related to #1271

About point (2), I wonder how much what is in the DCAT3 ED covers your requirements, e.g., in relation to the notion of "snapshot".

Another issue is to understand whether your use case fits in either the notion of version or dataset series.

@riannella
Copy link
Author

The "release type" has to do with the temporal aspects related to the dataset.
(See this for full details in aviation: http://aixm.aero/sites/aixm.aero/files/imce/AIXM511/aixm_temporality_1.1.pdf)

Perhaps we can use prov:wasGeneratedBy and indicate the activity that lead to this specific release:

prov:wasGeneratedBy http://aixm.aero/temporality/SNAPSHOT

@andrea-perego
Copy link
Contributor

@riannella said:

The "release type" has to do with the temporal aspects related to the dataset.
(See this for full details in aviation: http://aixm.aero/sites/aixm.aero/files/imce/AIXM511/aixm_temporality_1.1.pdf)

Perhaps we can use prov:wasGeneratedBy and indicate the activity that lead to this specific release:

prov:wasGeneratedBy http://aixm.aero/temporality/SNAPSHOT

Indeed. This approach is also documented in DCAT 2 - see §C.2 Dataset provenance.

@andrea-perego
Copy link
Contributor

@riannella , I wonder whether this issue needs further discussion.

Should that be the case, could you please share some possible examples of the types of relationships you think could be used to specify the release type?

E.,g., should they just specify the "type" of release (snapshot, delta, etc.), possibly by using a code list? Or there's the need of having (also) relationships linking to different versions / release types?

@riannella
Copy link
Author

I've tried to generalise these:

BASE - A release type in which the release dataset contains all permanent properties that are in effect
SNAPSHOT - A release type in which the release dataset contain all properties at are in effect at a particular time
DELTA - A release type in which the release dataset contains all new permanent properties
DELTATEMP - A release type in which the release dataset contains all new temporary properties

I think we just need the types.
I don't think there is a need (yet) to show the relationship between them.

@andrea-perego
Copy link
Contributor

Thanks, @riannella .

Based on what you say, I think "release type" is more related to alternative editions of a resource (prov:alternateOf) rather than to the notion of "version" used in PR #1295 currently under discussion - see preview here:

https://raw.githack.com/w3c/dxwg/dcat-versioning-v2/dcat/index.html#dataset-versions

About specifying the "types":

What could be used for this purpose in DCAT is dct:type (see §6.4.13 Property: type/genre), together with a SKOS code list for BASE, SNAPSHOT, etc. (to be defined outside DCAT).

Do you think this would work for you?

@riannella
Copy link
Author

We planned to use dct:type for something else, but now I think we shall use it for the "release type" (and use our own URIs).
Thanks :-)

@riannella
Copy link
Author

All done.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
dcat feedback Issues stemming from external feedback to the WG requirement versioning
Projects
None yet
Development

No branches or pull requests

3 participants