tent/tent.io — pull request #102 by longears (2012-10-04 18:21:12+00:00)
Title: Add to discovery docs (Link URLs can be absolute; entity URL can change)

Rebased and trying again.

@titanous said on the mailing list that Link URLs can be relative:
http://librelist.com/browser//tent.dev/2012/10/4/should-the-profile-link-always-be-absolute-or-is-relative-ok/#037cf4147ab37edefcf3fbca29d8a0e6

- - -

This also adds a note that the entity URL you start with before discovery might be different than the entity URL you end up with after discovery. Here's a case where that would happen:

Say I have an account at `https://me.tent.is`. I want people to be able to find it from my personal blog at `http://myblog.com`, so I add a `` header there pointing to `https://me.tent.is/tent/profile`.

Now someone does discovery starting with
`entityURL = "http://myblog.com"`

During discovery that profile URL will be fetched to get the API root URL and entity URL. The results will be:
```
apiRootURLs = ["https://me.tent.is/tent"]
entityURL = "https://me.tent.is"
```

This use case is like a redirect: if someone tries to follow me at `http://myblog.com` they will end up following the more canonical entity `https://me.tent.is`.

(Or if tent.is returned my blog link as my entity name, I would be able to use `http://myblog.com` as my entity name everywhere even though my tent server was actually tent.is)