Skip to content
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

Proposed improvements on the terminology section of the model #181

Closed
wants to merge 1 commit into from

Conversation

iherman
Copy link
Member

@iherman iherman commented Feb 26, 2016

I have tried to improve the wording of the Terminology section, surfacing each terms to the top and also making the description of classes (hopefully) a bit clearer (took over some terminology from the RDF Schema specification).

I have also used the respec tools to have definitions and an (easy) way to refer to the definition. It may be useful to put such references into the text (a bit tedious but should be doable with a good text editor...)


<dt>Property</dt>
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Not sure about adding SpecificResource here, especially given the discussion around #110? Will copy the details out (as they need to go into the template rather than index-respec directly.
[Edit: I see Property moved...]

@azaroth42
Copy link
Collaborator

I've copied over the vast majority:
http://w3c.github.io/web-annotation/model/wd2/#terminology

Other than the bits I commented on above.
Thanks Ivan!

@iherman
Copy link
Member Author

iherman commented Feb 27, 2016

Great.

A minor issue that may (but hopefully will not!) come up we will ever use OWL to express things. Indeed, in that case a class MAY be a blank node (defined through OWL expressions) which would complicate things: a class may be 'just' a resource, not necessarily a web resource. But, at the moment, this is irrelevant and, hopefully, it will stay so… Just flagging this for our own memory.

On 26 Feb 2016, at 20:27, Rob Sanderson notifications@github.com wrote:

I've copied over the vast majority:
http://w3c.github.io/web-annotation/model/wd2/#terminology http://w3c.github.io/web-annotation/model/wd2/#terminology
Other than the bits I commented on above.
Thanks Ivan!

@azaroth42
Copy link
Collaborator

Closing, as the content is in the draft now. Thanks again, Ivan!

@azaroth42 azaroth42 closed this Mar 3, 2016
@azaroth42 azaroth42 deleted the terminology-section-wording branch May 23, 2016 17:41
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.

None yet

2 participants