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