NASA-PDS / doi-service

Service and tools for generating DOIs for PDS bundles, collections, and data sets
https://nasa-pds.github.io/doi-service
Other
2 stars 3 forks source link

As a DOI user, I would like to know the copyright for PDS data #335

Closed jordanpadams closed 2 years ago

jordanpadams commented 2 years ago

💪 Motivation

...so that I can understand how I am allowed to use this data.

📖 Additional Details

⚖️ Acceptance Criteria

AC1: New DOI

Given a data set requiring a new DOI When I perform the steps to create a DOI Then I expect "US Government Works" copyright included in the DOI metadata submitted to DataCite

AC2: Update existing DOI

Given an existing DOI that was created prior to this ticket creation When I perform a query for the DOI Then I expect "US Government Works" copyright has been updated and included in the DOI metadata

⚙️ Engineering Details

alexdunnjpl commented 2 years ago

@jordanpadams please confirm exact desired text. Suggest:

This is a work of the U.S. Government and is not subject to copyright protection in the United States. Foreign copyrights may apply.

alexdunnjpl commented 2 years ago

@jordanpadams @nutjob4life is it known to be possible to submit metadata that is a superset of the schema?

The schema does not explicitly provide for a copyright attribute (though I'm open to correction on that, since it seems weird for it not to and I just ctrl-f'd "copyright").

I've implemented the metadata attribute in 489b0ff244197279366c8aa4055d34512e7ef155 and confirmed that it's included in the outgoing json payload, but the DataCite DOI record does not include the attribute, which would be consistent with the submissions being filtered through the official schema.

nutjob4life commented 2 years ago

Maybe in that schema the Rights slot (№16) could be used for copyright. It mentions:

Provide a rights management statement for the resource…Include embargo information if applicable.

It goes onto list Creative Commons and Apache as example values, but I could see having more complex copyright statements, ITAR conditions, warranty on use, etc., in there.

alexdunnjpl commented 2 years ago

@nutjob4life oh good pickup, thanks for that 🙏

alexdunnjpl commented 2 years ago

See the following example for default behaviour as-implemented. Currently, there is no interface for a user to provide custom rights metadata, as that is beyond the scope of this ticket and not a currently-obvious use-case.

{
  "id": "https://doi.org/10.13143/f08k-9z77",
  "doi": "10.13143/F08K-9Z77",
  "types": {
    "ris": "GEN",
    "bibtex": "misc",
    "citeproc": "article",
    "schemaOrg": "Collection",
    "resourceType": "PDS4 Collection ",
    "resourceTypeGeneral": "Collection"
  },
  "creators": [
    {
      "name": "J. R. Johnson",
      "nameType": "Personal",
      "nameIdentifiers": []
    }
  ],
  "titles": [
    {
      "lang": "en",
      "title": "edunn test 1.0 Bundle"
    }
  ],
  "publisher": "NASA Planetary Data System",
  "subjects": [
    {
      "subject": "PDS"
    },
    {
      "subject": "PDS4"
    }
  ],
  "contributors": [
    {
      "name": "Planetary Data System: Engineering Node",
      "nameType": "Organizational",
      "contributorType": "DataCurator"
    }
  ],
  "publicationYear": 2020,
  "language": "en",
  "identifiers": [
    {
      "identifier": "urn:nasa:pds:edunn_test::1.0",
      "identifierType": "Site ID"
    }
  ],
  "rightsList": [
    {
      "lang": "en-US",
      "rights": "This is a work of the U.S. Government and is not subject to copyright protection in the United States. Foreign copyrights may apply."
    }
  ],
  "relatedIdentifiers": [],
  "schemaVersion": "http://datacite.org/schema/kernel-4",
  "providerId": "nasapds",
  "clientId": "dev.fhpuqw",
  "agency": "datacite",
  "state": "draft"
}
alexdunnjpl commented 2 years ago

@jordanpadams taking a final pass over this issue, I realize I've missed AC2.

I'd suggest that the desired functionality should be that copyright metadata should be updated when-and-only-when a DOICoreActionUpdate is performed, rather than when the DOI is queried using a read-like DOICoreAction.

Please confirm.

jordanpadams commented 2 years ago

@alexdunnjpl sorry for the lack of clarity on AC2. The intent there was to use something like the Bulk Record Update notebook to go back and update all existing DOIs with this copyright (and licensing) information. The AC2 is really just how someone could query a DOI that already exists and see this info is there.

alexdunnjpl commented 2 years ago

Behaviour as-implemented: