Re: most of the links are toast in this document

Hi all,
have now fixed all the 200+ links that resulted in redirects.
and updated the spec
http://dvcs.w3.org/hg/html-api-map/raw-file/tip/Overview.html

On 5 January 2012 08:05, Steve Faulkner <faulkner.steve@gmail.com> wrote:
> Hi Mike, thanks for the explanation and quick fix!
>
> I will go through and check/update  the affected links so the point
> directly to the stable URLs in the next week or so.
>
>
> regards
> Steve
>
> On 5 January 2012 03:06, Michael[tm] Smith <mike@w3.org> wrote:
>> Hi Steve,
>>
>>> @2012-01-05 01:40 +0000:
>>> Hi Mike,
>>>
>>> Rich is correct that many of the links are incorrect, this appears due
>>> to changes in page content, URLs and doc fragment identifiers across
>>> revisions of the multipage version of the editors draft of HTML5.
>>>
>>> for example this URL
>>> http://dev.w3.org/html5/spec/grouping-content.html no longer includes
>>> the relevant content.
>>
>> Sorry about that -- I made some changes recently without checking to make
>> sure they actually took without breaking anything.
>>
>> What I did was to change the behavior of the splitter that generates the
>> multipage version, such that each element now has its own page; e.g.,
>>
>>  http://dev.w3.org/html5/spec/the-figcaption-element.html
>>
>> ...which was previously here:
>>
>>  http://dev.w3.org/html5/spec/grouping-content.html#the-figcaption-element
>>
>> Ironically, I did that in part in order to make the URLs more stable...
>>
>> But what I neglected to do was to check and make sure that the previous
>> URLs would automatically redirect to the current ones.
>>
>> But I've now fixed that. (Though it does rely on client-side Javascript in
>> order to do the redirect.)
>>
>> At some point when making changes I borked the part of the multipage build
>> that adds the calls to the JS function that does the redirects, but I've
>> un-borked it now, so it should work as expected going forward.
>>
>>> Can you advise on the stability of URLs etc over time?
>>
>> Most of the current URLs should be relatively stable. I can't guarantee
>> all of them, because sometimes they change upstream or end up getting
>> different number suffixes appended to them. But the URLs for the individual
>> elements are now stable at least.
>>
>> The existing links in the current APIs Implementation Guide should now all
>> "work" again -- in that they should redirect correctly (as long as you are
>> OK with the redirect depending on JS). But going forward, you should at
>> some point go through and update them to the actual correct targets.
>>
>>> Can you advise on a form of the HTML5 spec that is not out of date,
>>> but does include referencable URLs?
>>
>> Going forward, the dev.w3.org editor's draft should be that. I do not plan
>> on changing the splitter behavior again -- but if/when I ever do need to
>> for some reason, I will make sure to give everybody a heads-up.
>>
>> Again, I'm sorry for having messed this up.
>>
>>  --Mike
>>
>>> On 4 January 2012 22:58, Richard Schwerdtfeger <schwer@us.ibm.com> wrote:
>>> > This is a non-starter due to the links. I tried to have a meeting with an AT
>>> > vendor and this was a huge problem. When is the next meeting?
>>> >
>>> > https://dvcs.w3.org/hg/html-api-map/raw-file/tip/Overview.html
>>> >
>>> > Mike, please set me up as an editor.
>>> >
>>> > Thanks,
>>> >
>>> > Rich
>>>
>>>
>>>
>>
>> --
>> Michael[tm] Smith
>> http://people.w3.org/mike/+
>
>
>
> --
> with regards
>
> Steve Faulkner
> Technical Director - TPG
>
> www.paciellogroup.com | www.HTML5accessibility.com |
> www.twitter.com/stevefaulkner
> HTML5: Techniques for providing useful text alternatives -
> dev.w3.org/html5/alt-techniques/
> Web Accessibility Toolbar - www.paciellogroup.com/resources/wat-ie-about.html



-- 
with regards

Steve Faulkner
Technical Director - TPG

www.paciellogroup.com | www.HTML5accessibility.com |
www.twitter.com/stevefaulkner
HTML5: Techniques for providing useful text alternatives -
dev.w3.org/html5/alt-techniques/
Web Accessibility Toolbar - www.paciellogroup.com/resources/wat-ie-about.html

Received on Tuesday, 10 January 2012 18:19:35 UTC