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

dc/dcterms: source #94

Open
tombaker opened this issue Jan 15, 2020 · 9 comments
Open

dc/dcterms: source #94

tombaker opened this issue Jan 15, 2020 · 9 comments

Comments

@tombaker
Copy link
Collaborator

tombaker commented Jan 15, 2020

EDITED

  • dc11:source (through 2019)

    Comment reads: "The described resource may be derived
    from the related resource in whole or in part.
    Recommended best practice is to identify the related
    resource by means of a string conforming to a formal
    identification system."

  • dcterms:source (ISO 15836-2 / DCMIMT 2020)

    Comment reads: "This property is intended to be used
    with non-literal values."

CHANGING NOW (unless I hear objections!)

  • dc11:source (DCMIMT 2020)

    No changes.

PROPOSING FOR FUTURE (to be voted)

  • dc11:source

    Declare equivalent to dcterms:

    Change comment as per dcterms:

@kcoyle
Copy link
Collaborator

kcoyle commented Jan 16, 2020

I like the dc11 definition better. Also, I don't see where we decided to change the definition of the dcterms:source. I tried a search on the closed issues and don't see it.

@tombaker
Copy link
Collaborator Author

tombaker commented Jan 16, 2020 via email

@tombaker
Copy link
Collaborator Author

In DCMIMT of 2012-06-14, which is still the "latest
version" on the DCMI website, the usage comment for
dcterms:source reads [1]:

The described resource may be derived from the
related resource in whole or in part. Recommended
best practice is to identify the related resource by
means of a string conforming to a formal
identification system.

In addition, the description of dcterms:source in the RDF
schema of 2012-06-14 has a skos:note that reads [2]:

This term is intended to be used with non-literal
values as defined in the DCMI Abstract Model
(http://dublincore.org/documents/abstract-model/).
As of December 2007, the DCMI Usage Board is seeking
a way to express this intention with a formal range
declaration.

Indeed, this comment had become a source of embarrassment.

Thanks to the Wayback Machine, I see that the note
disappeared from the DCMI Metadata Terms web page between
2019-03-07 [3] and 2019-03-21 [4], which is when we
started using
http://www.dublincore.org/specifications/dublin-core/dcmi-terms/
as the address for DCMIMT (the address
http://dublincore.org/documents/dcmi-terms/ is now an
alias and still resolves).

In the meantime, on 2018-06-06, we had unanimously
approved a resolution [6] to replace the old text with:

This property is intended to be used with non-literal
values.

At the time, I neglected to transcribe this decision to
the decision record on Github but have now rectified this
omission [7].

As of 2018-06-04, the "Note 1 to entry:" for
dcterms:source in the ISO draft read:

Best practice is to identify the related resource by
means of a URI or a string conforming to a formal
identification system.

This text raises two issues:

  1. What happened to the following text?

    The described resource may be derived from the
    related resource in whole or in part.

The answer, I find, is that the sentence went missing in
a very early draft of ISO 15836-2. I pointed out this
omission in an email to the ISO draft editors on
2017-03-07, but unfortunately I neglected to follow up
and verify that the text was restored, so it remained
missing.

  1. Where did the words "a URI or" come from?

The answer, I find, is that the editor of the ISO draft
proposed the additional words for inclusion in the usage
comment for dcterms:relation and we unanimously approved
this change on 2018-06-20 [9]. We approved this change
specifically for dcterms:relation, not for
dcterms:source, but since dcterms:source is a
sub-property of dct:relation, the change was applied to
dcterms:source in the ISO draft as well.

The ISO draft of 2018-07-11 [8] shows that a new
"Note 1 to entry:" was added to the fifteen
properties, such as hasFormat, subject, references,
relation... and source.

For fourteen of the fifteen properties, the new "Note 1
to entry:" was added to the existing usage comment, which
became "Note 2 to entry:".

For dcterms:source, however, the existing comment was
deleted, so that the term description now had just one
"Note 1 to entry:".

AFAICT, we never decided to delete the existing comment,
so I consider this omission to be a simple error. I have
restored the comment in its current form, with the
additional words "a URI or", plus the additional sentence
about "intended to be used with non-literal values". In
DCMIMT, we do not split comments into separate "Note x to
entry" sections, so the comment for dcterms:source now
reads, for publication on Monday:

This property is intended to be used with non-literal
values.  The described resource may be derived from
the related resource in whole or in part.  Best
practice is to identify the related resource by means
of a URI or a string conforming to a formal
identification system.

Thank you, Karen, for drawing attention to this problem.

One takeaway for me, having just spent alot of time
reconstructing the situation, is that every decision
taken in a Github issue, however minor (within reason),
should be transcribed into a decision document in the
'minutes' tree on Github.

[1] https://www.dublincore.org/specifications/dublin-core/dcmi-terms/#terms-source
[2] https://www.dublincore.org/2012/06/14/dcterms.ttl
[3] https://web.archive.org/web/20180615154517/http://dublincore.org/documents/dcmi-terms/#terms-source
[4] https://web.archive.org/web/20190307110144/http://dublincore.org/documents/dcmi-terms/#terms-source - March 7
[5] https://web.archive.org/web/20190321010804/http://www.dublincore.org/specifications/dublin-core/dcmi-terms/#terms-source
[6] #27 (comment)
[7] https://github.com/dcmi/usage/blob/master/minutes/2018/2018-06-03.dcub-decisions.md
[8] https://github.com/dcmi/iso15836-2/blob/master/drafts/superseded/ISO_CD_15836-2_2018-07-11.pdf
[9] #28 (comment)

@aisaac
Copy link
Collaborator

aisaac commented Jan 17, 2020

I can live with publishing the new suggested note (with all the discussed "components"). But actually I would be happier if we could avoid "Best practice is to identify the related resource by means
of a URI or a string conforming to a formal identification system.". This sounds a bit at odds with "This property is intended to be used with non-literal values."

As a matter of fact I think I do not like the idea of propagating usage notes from a super-property to a sub-property. Sure, the semantics of super-properties should still apply to sub-properties. But in general I expect sub-properties will somehow refine the semantics of the super-property, so it seems unhelpful to re-stick the general notes right next to the generic ones.
Had we decided somewhere that we wanted to enforce this propagation in our notes? Do we do it for other properties than dcterms:source?

@kcoyle
Copy link
Collaborator

kcoyle commented Jan 17, 2020

I agree with @aisaac that we need to give ourselves a task of looking again at the subclass relationships and the definitions of terms. When we were going over the ISO document it was kind of piecemeal and I admit that I didn't think hard about how it all fit together. I would like the 1.1 values to be as wide open as possible, consistent with their historical usage as essentially key/value pairs. (I guess they'd be owl:AnnotationProperty's) So we need to adjust the definitions and comments to fit this.

@Flaminggay
Copy link

EDITED

  • dc11:source (through 2019)
    Comment reads: "The described resource may be derived
    from the related resource in whole or in part.
    Recommended best practice is to identify the related
    resource by means of a string conforming to a formal
    identification system."
  • dcterms:source (ISO 15836-2 / DCMIMT 2020)
    Comment reads: "This property is intended to be used
    with non-literal values."

CHANGING NOW (unless I hear objections!)

  • dc11:source (DCMIMT 2020)
    No changes.

PROPOSING FOR FUTURE (to be voted)

  • dc11:source
    Declare equivalent to dcterms:
    Change comment as per dcterms:

{{Supplement}}

@Flaminggay
Copy link

Ф

@Flaminggay
Copy link

@Flaminggay
Copy link

[endpoint][endpoint]

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants