[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 #9 from Shelley Powers <shelleyp@burningbird.net> 2011-06-29 12:50:20 UTC ---
(In reply to comment #8)
> 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.

Looks good! 

I appreciate the work. And thanks for the additional work finding the remaining
attributes without the "author friendly" view.

This generated document is going to be much more approachable to the web page
designers and developers who just don't need the implementation material. 

Thanks again for your effort. Should we mark this as resolved, and close it
since you'll handle those without author friendly description in a separate
bug?

-- 
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 12:50:28 UTC