search

HydraCG / Specifications

Specifications created by the Hydra W3C Community Group
Other
139 stars 25 forks source link

improved examples using Comment class #106

Closed elf-pavlik closed 8 years ago

elf-pavlik commented 8 years ago

During presentation at http://paris.apidays.io/ last Tuesday I showed examples of defining properties of Comment class and operation on collection of comments. http://www.slideshare.net/elfpavlik/api-standardization-work-in-w3c-groups/94

IMO with modifications proposed in his PR one could explain it much more easily. Now it also encourages to reuse existing vocabularies like schema.org. Which matches @lanthaler's presentation from last year http://www.slideshare.net/lanthaler/the-web-is-changing-from-strings-to-things/8

lanthaler commented 8 years ago

I imagine this will result in many comments regarding "polluting" the vocabulary definition etc. and that the class should be subclassed instead. Let's see if we come up with a more elegant design when we discuss operations (or are able to reuse SHACL or something) instead of doing of quick fix now. WDYT?

elf-pavlik commented 8 years ago

SGTM, maybe worth adding note about planned changes inline in the spec?