Next in thread → Next in month →

RE: [xri] Pre-draft of "HTTP-based Resource Descriptor Discovery"

From
Eran Hammer-Lahav <>
Date
2009-01-09T09:02:25+00:00
ID
Thread
RE: [xri] Pre-draft of "HTTP-based Resource Descriptor Discovery"
Awesome! Thanks Drummond. The current draft is almost twice as long after a day of revisions. I just need to add an example at the top of the spec and it should be ready for publication. I also added a straw man for the DNS declaration idea and noted some open questions.

> -----Original Message-----
> From: Drummond Reed [mailto:]

> 7.2 How much of this section repeats normative requirements of
> I-D.nottingham-http-link-header vs. how much are new requirements of
> this
> profile? It's good to repeat the most relevant requirements here, but
> it's
> important to distinguish which ones are from that spec versus which
> ones are
> unique to this "profile" of that spec. You might even want to break
> them
> into a 7.2.1 and 7.2.2 to do that.

Link-header only provides the header format. I extended the section to provide a step by step instruction. When you see the next version, let me know if this is still an issue.

> 7.3 Fourth/Fifth Paras: - I think I know what you are trying to say
> here but
> these paras are not enough to communicate a really hard concept --
> which is
> actually quite a critical one for implementers. I personally think this
> point requires a longer explanation and at least one example and thus
> should
> get its own subsection called something like "7.3.1 Abstract Site Vs.
> Concrete Root Resource Description".

I would like to add this to the Site-Meta spec in some form to clarify it (so that people will not assume Site-Meta is the same as root resource links). I already completely changed this section so let me know what you think when you review again.

EHL
Next in thread → Next in month →