Skip to content
This repository was archived by the owner on Jun 18, 2024. It is now read-only.

Remove the uppercase field names #77

Closed
JoshData opened this issue Jun 23, 2013 · 4 comments
Closed

Remove the uppercase field names #77

JoshData opened this issue Jun 23, 2013 · 4 comments

Comments

@JoshData
Copy link
Contributor

On the schema page (http://project-open-data.github.io/schema/), why is every field listed with an uppercase "Field" name (e.g. "Release Date") and a lowercase "JSON" name (e.g. for Released Data, the corresponding JSON name is "issued")?

The only place the uppercase names are used seems to be be the Metadata page (http://project-open-data.github.io/metadata-resources/), where it is a link to the cross-walk table to the other vocabularies.

Do they have some other purpose? If they're not supposed to ever appear in any data file, they should be removed from the specification.

@jpmckinney
Copy link
Contributor

It's common to give a brief human-readable label to a field. That is what appears in the "Field" column.

@JoshData
Copy link
Contributor Author

But the JSON field name is human readable, so.....

@jpmckinney
Copy link
Contributor

True, but that's not guaranteed to be the case. mbox, among others, is pretty meaningless.

@MarinaNitze
Copy link
Contributor

Thanks for your feedback! We feel human-readable names are important here, especially when mapping across multiple schemas.

haleyvandyck pushed a commit that referenced this issue Feb 19, 2014
…bels

Closes #154 and updates #77 - Separates out confusing field name labels
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants