Re: Proposal: use images in examples

On Mon, 11 Feb 2013 19:36:57 +0100, Travis Leithead  
<travis.leithead@microsoft.com> wrote:

>
> Fantastic. I love pictures!

So do I.

Specs are misery to read. A few pictures can really make a difference to  
understanding what is happening. (I'd love to have a requirement that  
every algorithm be accompanied by a nice friendly picture that functions  
as a flowchart, but I think that's creating a lot of work that would get  
in the way of other important stuff. Maybe webplatform.org will do them...)

cheers

>
>
> From: Steve Faulkner [mailto:faulkner.steve@gmail.com]Sent: Saturday,  
> February 9, 2013 3:06 AM
> To: Travis Leithead
> Cc: HTMLWG WG
> Subject: Re: Proposal: use images in examples
>
>
> Hi Travis,
> Have now added an example of what I am suggesting in the spec (as part  
> of resolving a bug https://www.w3.org/Bugs/Public/>show_bug.cgi?id=9216):
>
> http://www.w3.org/html/wg/drafts/html/master/embedded-content-0.html#captcha-images
>
> feedback welcome!
>
> regards
> Steve
>
> On 4 February 2013 17:24, Steve Faulkner <faulkner.steve@gmail.com>  
> wrote:
>>
>> Hi Travis,
>> the latter:
>>
>>> Or are you asking for a pictorial representation of a concept?
>>
>> using an image as an adjnct to a code example to aid comprehension
>>
>> an example in the spec:  
>> http://www.w3.org/html/wg/drafts/html/master/interactive-elements.html#interactive-elements
>>
>> another example from the alt text doc:  
>> http://dev.w3.org/html5/alt-techniques/#sec1
>>
>>
>> regards
>> Stevef
>>
>>
>> On 4 February 2013 17:10, Travis Leithead  
>> <travis.leithead@microsoft.com> wrote:
>>>
>>> Hmm. Are you asking for the HTML5 spec source to support an  
>>> HTML5-introduced spec concept (i.e., use the feature in the source  
>>> >>>for the spec)? That seems a bit unusual to me... Or are you asking  
>>> for a pictorial representation of a concept? (The latter sounds like  
>>> >>>an excellent suggestion, as 1 picture = 1000 words—so they say.)
>>>
>>>
>>> From: Steve Faulkner [mailto:faulkner.steve@gmail.com]Sent: Monday,  
>>> February 4, 2013 4:23 AM
>>> To: HTMLWG WG
>>> Subject: Proposal: use images in examples
>>>
>>>
>>> Hi all,
>>> In HTML 5.1
>>>
>>> In cases where images are an important part of a code example, I think  
>>> it would be beneficial to authors understanding of element >>>use to  
>>> add an example of the image/elements in context reflecting the current  
>>> code examples.
>>>
>>> For example, in the section on the use of the figure element [1]  
>>> images could be added like they are in the alt text guidance doc [2]
>>>
>>> thoughts?
>>>
>>> [1]  
>>> http://www.w3.org/html/wg/drafts/html/master/grouping-content.html#the-figure-element
>>> [2] http://dev.w3.org/html5/alt-techniques/#nested
>>>
>>> --with regards
>>>
>>> Steve Faulkner
>>>
>>>
>>
>>
>>
>>>> --
>> 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



-- 
Charles McCathie Nevile - Consultant (web standards) CTO Office, Yandex
chaals@yandex-team.ru Find more at http://yandex.com