RE: proposal: modify the figure element

>From: Steve Faulkner [mailto:faulkner.steve@gmail.com] 
> Sent: Thursday, June 20, 2013 7:39 AM
> 
> hi mallory, 
> 
> >I don't know how clear that explanation would seem to the average dev (code
> >examples would solve that though).
> 
> do you have suggestions for how the text could be made clearer?

I know you didn't ask me...

This part confused me (though on the site I can see that "label" isn't wrapped in a <code>, though on first read I assumed it referenced the <label> element):

"Authors are encouraged to consider using labels to refer to figures, rather than using  such relative references, so that the page can easily be restyled without affecting the page's  meaning."

Since you asked about the text, perhaps reference coding methods?

"Authors are encouraged to consider using labels (whether by anchor links, ARIA described-by, or other discovery methods within the code) to refer to figures, rather than using  such relative references, so that the page can easily be restyled without affecting the page's  meaning."

And then show an example:

<a href="#Figure1">Figure 1 shows an example of pasta consumption over time</a>.

<figure id="Figure1">
[SVG, IMG, etc]
<figcaption> Figure 1: Pasta consumption over time.</figcaption>
</figure>

Received on Thursday, 20 June 2013 14:05:34 UTC