Skip to content

Each term definition should end with a period / full stop, i.e. ".". #294

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

Closed
danbri opened this issue Jan 28, 2015 · 2 comments
Closed

Each term definition should end with a period / full stop, i.e. ".". #294

danbri opened this issue Jan 28, 2015 · 2 comments
Assignees
Labels
schema.org vocab General top level tag for issues on the vocabulary type:cleanup + clarity Addresses wording fixes, ambiguities, confusion, bad examples etc

Comments

@danbri
Copy link
Contributor

danbri commented Jan 28, 2015

We have been consistently inconsistent with this, historically. The ideal that was agreed a while back was that labels are simple strings with no ".", matching the portion of the term URI after 'schema.org/', while the description (i.e. rdfs:comment) would most properly end with a period / full stop.

This can be checked, roughly, with a SPARQL query. See: http://dydra.com/danbri/schema-org/query#comments-not-ending

SELECT * WHERE { ?p rdfs:comment ?c FILTER regex(str(?c), "[^.]\\s*$") } 

There are some corner cases and details:

  • descriptions ending in markup
  • descriptions ending with a raw list of URLs (i.e. those from Good Relations where we enumerate external values)

Apart from those, e4a6b88 addresses about 100 easier cases.

@danbri danbri added type:enhancement schema.org vocab General top level tag for issues on the vocabulary type:cleanup + clarity Addresses wording fixes, ambiguities, confusion, bad examples etc labels Jan 28, 2015
@danbri danbri self-assigned this Jan 28, 2015
@danbri danbri added this to the sdo-stantz release milestone Jan 28, 2015
danbri referenced this issue Jan 28, 2015
Also removed redundant supercededBy text from partOfTVSeries,
contentUrl and embedUrl, and redundant domain/range text from
audienceType.
@danbri
Copy link
Contributor Author

danbri commented Jan 28, 2015

After today's changes, the following terms match the SPARQL FILTER regex(str(?c), "[^.]\s*$":

GoodRelations-based terms that end with a list of URLs:

A next step could be to create a unit test to discourage the addition of term definitions that end without a final '.' - tracked as #250.

It would also be useful to improve the SPARQL filter to accept newlines and escaped '>' chars.

@danbri
Copy link
Contributor Author

danbri commented Jan 29, 2015

Closing this as addressed in all reasonable cases. Leaving #250 open to get a unit test in place to police the situation better in future.

@danbri danbri closed this as completed Jan 29, 2015
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
schema.org vocab General top level tag for issues on the vocabulary type:cleanup + clarity Addresses wording fixes, ambiguities, confusion, bad examples etc
Projects
None yet
Development

No branches or pull requests

1 participant