[Bug 13038] Still a silly lang attribute, and inconsistencies in the HTML5 Edition for Web Authors

http://www.w3.org/Bugs/Public/show_bug.cgi?id=13038

--- Comment #8 from Michael[tm] Smith <mike@w3.org> 2011-06-29 07:14:50 UTC ---
OK, as far as the links I found that weren't getting rewritten as expected, I
figured out the reason and I've fixed it... sorta

What I mean by "sorta" is, if you go here:

  http://dev.w3.org/html5/spec-author-view/the-track-element.html#texttrack_2

...and then you click on the link for the "textTracks" attribute there
(href=#dom-media-texttracks), it actually takes you to the description of
"media.textTracks.length" attribute -- not to the description of the
"media.textTracks" object itself.

But, the description for the "media.textTracks" object is right there in the
same "domintro" box, just below the "media.textTracks.length" description.

There aren't many cases like this -- only about 20 or so in the whole spec (I
know because I had to write some special-casing to handle them) -- and I think
for all of them the "real" intended description is going to be in close enough
proximity that you won't likely notice it's not taking you to the exact anchor
for the description you need.

So while that's certainly suboptimal, I hope it's judged close enough to be
acceptable.

The thing is, due to funkiness of the hack I'm using to rewrite the link
targets, it would be a lot of extra special casing to get those links to
rewritten to the exact targets (and probably some further regressing while I'm
monkeying around with it...). Which is not to say it's not doable, but just not
sure it's worth it unless there are some links that are ending up going
somewhere way off from where they should be.

Anyway, all that said, you will still find attributes in some IDLs that will
take you to targets in the full spec (instead of to ones in the author view).
For example, if you go here:

 
http://dev.w3.org/html5/spec-author-view/the-track-element.html#htmlmediaelement

...and scroll down and check the links for some of the attributes -- e.g.,
"autoplay" and "loop" -- you'll see that they point back to the full spec.

As far as I can tell the reason for all those remaining cases is just that
there are not (yet) any "domintro" (author-friendly) descriptions of those
attributes in the spec. So I think the fix is just for "domintro" descriptions
for those to actually be added.

I think I can actually generate a list of all the attributes for which that's
the case. So I think I'll do that and file a separate bug report for it.

In the mean time, I think I'll take another break from pulling threads on this
so that I don't re-regress anything. So please do check it again now and if you
find anything that it seems like I missed, post some more comments.

-- 
Configure bugmail: http://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.

Received on Wednesday, 29 June 2011 07:14:52 UTC