W3C home > Mailing lists > Public > public-linked-json@w3.org > January 2014

Re: Redirecting specs to w3.org

From: Gregg Kellogg <gregg@greggkellogg.net>
Date: Fri, 17 Jan 2014 10:38:34 -0800
Cc: "David I. Lehn" <dil@lehn.org>, Linked JSON <public-linked-json@w3.org>
Message-Id: <9696A2EA-1806-47DC-9FFE-7ABCEEEBFCE4@greggkellogg.net>
To: Markus Lanthaler <markus.lanthaler@gmx.net>
On Jan 17, 2014, at 10:31 AM, Markus Lanthaler <markus.lanthaler@gmx.net> wrote:

> On Friday, January 17, 2014 6:32 PM
>> 
>> On Fri, Jan 17, 2014 at 6:13 AM, Markus Lanthaler
>> <markus.lanthaler@gmx.net> wrote:
>>> I'm wondering whether we should set up a temporary redirect for the
>> specs to
>>> w3.org now that they've become RECs:
>>> 
>>>  http://json-ld.org/spec/latest/json-ld/
>>>    -> http://www.w3.org/TR/json-ld/
>>> 
>>>  http://json-ld.org/spec/latest/json-ld-api/
>>>    -> http://www.w3.org/TR/json-ld-api/
>>> 
>>> This would make it clear that there's (at least currently) only a
>> single
>>> version of the spec. As soon as we start working on these document
>> again, we
>>> just remove the redirect.
>>> 
>> 
>> -1
>> 
>> I don't think we should be switching around the meaning of those
>> spec/latest/ links.  Let's keep those pointing at the latest draft
>> from this group.
> 
> Well, that's the REC at w3.org.
> 
> 
>> One reason is people may use the json-ld.org link vs
>> w3.org one and then when we change the meaning of those links, they
>> would be pointing at the wrong document.
>> 
>> How about this: On the website navbar dropdown, add a group at the top
>> called "Recommendations" that links to the latest w3.org docs and
>> change the text "Latest" to "Latest Draft" (and still use spec/latest/
>> for the link).  Then on the spec/ page, for each doc with official
>> recommended specs, add another line with links to each recommedation
>> doc, and change the "Links to JSON-LD specifications" text to "Links
>> to JSON-LD drafts".
> 
> Yeah, that's great but overkill till we really update the drafts. We
> hopefully don't have to for a while.
> 
> People have been waiting hard for a stable spec. I think the most important
> thing to do now is to show them that they are stable now. Confusing them
> with different documents (even if they might contain exactly the same
> content) is counterproductive at the moment. Just redirecting them
> (temporarily) to w3.org sends a strong enough signal. As soon as we make
> changes, we can switch back and serve the new latest speck at json-ld.org.
> 
> Does that make sense?

I agree, right now, and for some time to come, the "latest" version of these specs are the REC, so best redirect to them. At some point, either when we integrate errata or begin work on JSON-LD 1.1, the latest links can again be for the editor's draft versions, and we can undo the redirect.

Gregg

> --
> Markus Lanthaler
> @markuslanthaler
> 
> 
Received on Friday, 17 January 2014 18:39:04 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 16:18:40 UTC