these are important 1. use hyperlinks and link relations i.e. <link href="/people/bob" rel="friend" /> 2. don't bother with multiple media types (unless /abso

these are important 1. use hyperlinks and link relations i.e. <link href="/people/bob" rel="friend" /> 2. don't bother with multiple media types (unless /absolutely/ necessary) . If appropriate try to use/extend an established type such as Atom/AtomPub 3. make sure you set your cache control headers appropriately