Skip to content

Generate example#1

Open
eldeal wants to merge 2 commits intomasterfrom
generate-example
Open

Generate example#1
eldeal wants to merge 2 commits intomasterfrom
generate-example

Conversation

@eldeal
Copy link
Copy Markdown
Owner

@eldeal eldeal commented May 31, 2018

Sample JSON output using ONS data available here: https://api.beta.ons.gov.uk/v1/datasets/ashe-table-7-hours/editions/time-series/versions/1/metadata

We envisage a link to this JSON will be served as one of the distribution/download options from the above link, and that when the downloads.ons....file.json link is accessed the appropriate media type headers will be set on that response.

Questions on what we have done:

  • Can't find the permitted fields for a "dct:publisher" - are the ones we're using acceptable? Should @type come from some enumerated list?
  • Are the valueURLs the correct thing to use? Each value in that column could be put in the placeholder of the URL and link to metadata about what that value means
  • Is motivation required for notes?
  • Can notes reference the whole document? (Our example references columns but we have 'Corrections' which apply to the entire document sometimes)

Questions on what we haven't:

  • How much validation (if any) is necessary?

I've tried to use DCAT vocabulary where applicable in this example. It seems that Schema.org might hold more value in a strictly web setting, but as our current intention is that this file is downloaded DCAT seemed more fitting. Is it even appropriate for this JSON file to be a download, or must it be redirected to as a page/endpoint in its own right?

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant