Need a way to capture a Title and Description for each resource in the Distribution array

[cew821]

The required fields for the distribution type are accessURL and format i.e. MIME-type. I think we should consider adding two additional fields (which could be optional) to the distribution type, which would be resourceTitle and resourceDescription.

Right now, if data managers create a data record using CKAN (i.e. using inventory.data.gov), the data manager is prompted to provide a Title and Description in addition to the accessURL/webService and File Format. When a user browses the inventory within that CKAN instance, they see this title and description as a part of the record. See this screenshot for an example:

However, since the schema doesn't have a field for these Title and Description elements, this data is lost when the data.json file is generated from the inventory. As a result, users of catalog.data.gov don't see a title or description for each resource, even if it was originally provided by a data manager in inventory.data.gov:

I propose that we add some optional fields to the schema that would allow each object in a distribution include a resourceTitle and resourceDescription text field, which, if present, could be used by catalog.data.gov and other catalogs to provide users of the catalog more information about each resource in the distribution.

[dsmorgan77]

👍

[pschweitzerusgsgov]

Yes.

DCAT has these fields in its Distribution type, so it should be a simple matter to take notice of them if present.

[haleyvandyck]

Thanks for this-- looks good. We've added it to the list of things to consider with the next schema update.

[bletalien]

Please!!! Here's an example of why: http://catalog.data.gov/dataset/general-schedule-and-locality-pay

[gbinal]

There seems to be a lot of support from this (I literally just heard someone say 'yes, yes, yes please').

What seems to be at issue is not necc. adding new fields but providing guidance for how these could be used within the distribution when an agency has the complexity and feels strongly about it.

+1

[smrgeoinfo]

classic example! @gbinal are you arguing against adding link properties for the accessURLs?

[dafeder]

I think the idea would be to use existing title and description field names inside the distribution array (rather than add new field names to the schema, especially using the term "resource" which is CKAN-specific). This would be consistent with DCAT: http://www.w3.org/TR/vocab-dcat/#class-distribution

[smrgeoinfo]

So the idea would be to extent the current https://project-open-data.github.io/schema/ distribution that has an accessURL and format to include dcat:title and dcat:description?

from the current POD distribution documentation:
"Distribution is a concatenation, as appropriate, of the following elements: accessURL and format. If an entry has only one dataset, enter details for that one; if it has multiple datasets (such as a bulk download and an API), separate entries as seen below:"

[dafeder]

That would certainly make sense for CKAN and DKAN! Agree they should both be optional.

[dafeder]

Except, when implementing as RDFa it would be dct:title, not dcat:title. JSON would use simply title.

[gbinal]

There's been pretty good agreement on allowing for this, though not requiring it. Also,

• That it needs to in sync with DCAT
• This said, though, distribution is still not meant for gathering similar datasets - that is what the collection discussion in Issue Guidance on defining collections to group datasets released as a series or in fragments #258 is for.