Comments on: What are links http://barelyenough.org/blog/2010/01/what-are-links/ … and there is much to be learned Tue, 17 Jan 2012 22:46:55 +0000 hourly 1 http://wordpress.org/?v=3.3.1 By: uberVU - social comments http://barelyenough.org/blog/2010/01/what-are-links/comment-page-1/#comment-79837 uberVU - social comments Sun, 17 Jan 2010 13:29:36 +0000 http://barelyenough.org/?p=422#comment-79837 <p><strong>Social comments and analytics for this post...</strong></p> <p>This post was mentioned on Twitter by mamund: What are links http://ff.im/-dWv25...</p> Social comments and analytics for this post…

This post was mentioned on Twitter by mamund: What are links http://ff.im/-dWv25…

]]> By: Mike Amundsen http://barelyenough.org/blog/2010/01/what-are-links/comment-page-1/#comment-79712 Mike Amundsen Thu, 07 Jan 2010 15:21:03 +0000 http://barelyenough.org/?p=422#comment-79712 <p>You've expressed one of the dilemmas I am wrestling with right now regarding defining media-types.</p> <p>When defining a media-type, you can use relations to tell clients "what to do" with the link and then document the <em>way</em> that should be done. Or you can tell clients "what data is available" and then document what actions (methods) can be executed on that data.</p> <p>Currently, I like the first option because it offer the ability to use domain-specific verbs that might be familiar to the client.</p> <p>But I'm not at all convinced that this is the proper path.</p> You’ve expressed one of the dilemmas I am wrestling with right now regarding defining media-types.

When defining a media-type, you can use relations to tell clients “what to do” with the link and then document the way that should be done. Or you can tell clients “what data is available” and then document what actions (methods) can be executed on that data.

Currently, I like the first option because it offer the ability to use domain-specific verbs that might be familiar to the client.

But I’m not at all convinced that this is the proper path.

]]>