clarify the use of the term "semantic"

alps-io / spec

ALPS Specification documents.

59 stars 13 forks source link

clarify the use of the term "semantic" #66

Closed mamund closed 9 years ago

mamund commented 9 years ago

Section 2.2.12

I'm not understanding what you mean by the description of type="semantic". The examples given (html.span and html.input) aren't helping in this respect.

My guess is that some kind of introduction to the kind of hypermedia model your basing this upon is needed. I think there's a lot of tacit knowledge permeating the spec that needs to be surfaced for those who aren't in tune with your approach.

/via Graham Klyne

fosrias commented 9 years ago

@mamund I really think this would be better served to use something like a JSON property or an xml tag(or attribute?). HTML is too far removed.

mamund commented 9 years ago

you mean in the example cases in the spec doc?

when mapping a profile onto HTML, we still need to use some element, right? and span and input are proper examples of mapping "semantic" descriptors, right?

fosrias commented 9 years ago

Yeah. I think that is fine, but it is far more abstract than some example of showing a semantic descriptor being a json property on JSON or some equivalent in xml. Could leave in the HTML, but may the semantic section warrants some code examples for clarity.

mamund commented 9 years ago

maybe we need an additional section up near the top, too.