Re: What is the correct media-type for a Hydra specification?

On 4/16/15 6:48 PM, Erik Wilde wrote:
> a link enables a client to follow that link because it wants to 
> achieve a certain goal ("i'd like to GET API doc"). *what kind* of API 
> doc it finds is a runtime issue.

A Link is an association mechanism that connects two things. <#This> 
<#isConnectedTo> <#That> .

You are redefining what <#isConnectedTo> Identifies, assuming "follow" 
wasn't just a loose word choice. I think "lookup the meaning or 
descriptoin" of its referent is what HTTP URI based hyperlinks 
facilitate. For instance, <#That> could *identify* an entity of Type 
document, but that doesn't imply <#This> also *identifies* an entity of 
type document, even though we perceive their respective meanings 
(descriptions or connotations) via hypermedia.

In HTML <a/> is a look-up control.

A client can look-up any of the following: <#This>, <#isConnectedTo>, or 
<#That>, en route to understanding the *nature* of what they identify.

Add some *explicit*  semantics to the roles of <#This>, 
<#isConnectedTo>, or <#That> based on syntax rules for their specific 
arrangement (i.e., sentence construction), and you end up with "parts of 
speech roles" in the form of Subject, Predicate, and Object .

Demo:

{
## What follows will even turn this post into RDF based Linked Open Data 
once its URL is published by its mail server
## Simple RDF Language Demo

<>
a schema:WebPage ;
dcterms:format "text/html" ;
schema:about
<#This>, <#isConnectedTo>, <#That> ;
schema:url <> .

<#isConnectedTo> a rdf:Property .

<#This> a foaf:Person ;
rdfs:label "Some Person Instance" .

<#That> a foaf:Document ;
dcterms:format "application/pdf" ;
schema:url <http://www.jfsowa.com/pubs/fflogic.pdf> ;
rdfs:label "Some Document Instance" .

}

Links:

[1] http://kingsley.idehen.net/c/94X6PQ2 -- Above pasted into a document 
and saved to my personal data space
[2] http://kidehen.blogspot.com/2014/07/nanotation.html -- How I am able 
to turn this mail exchange into Linked Open Data (comprehensible to both 
humans and machines) via RDF Language exploitation
[3] http://linkeddata.uriburner.com/c/9PEWHRC -- About Hydra's API 
Documentation Class .

-- 
Regards,

Kingsley Idehen 
Founder & CEO
OpenLink Software
Company Web: http://www.openlinksw.com
Personal Weblog 1: http://kidehen.blogspot.com
Personal Weblog 2: http://www.openlinksw.com/blog/~kidehen
Twitter Profile: https://twitter.com/kidehen
Google+ Profile: https://plus.google.com/+KingsleyIdehen/about
LinkedIn Profile: http://www.linkedin.com/in/kidehen
Personal WebID: http://kingsley.idehen.net/dataspace/person/kidehen#this