W3C home > Mailing lists > Public > whatwg@whatwg.org > September 2011

[whatwg] Editorial comment r/e summary element

From: Bruce Lawson <brucel@opera.com>
Date: Tue, 20 Sep 2011 13:49:14 +0100
Message-ID: <op.v13xwcbbh8on37@bruce-pc>
Fair dames and damsels of the list

Consider  
http://www.whatwg.org/specs/web-apps/current-work/multipage/interactive-elements.html#the-summary-element:  
"The summary element represents a summary, caption, or legend for the rest  
of the contents of the summary element's parent details element, if any."

I read "if any" to mean there may or may not be "a summary, caption or  
legend".

However, a questioner to HTML5 Doctor believes that <summary> can be used  
outside <details>, reading "if any" to sugest that there may not be a   
"summary element's parent details element".

(She wants to use <summary> at the top of an article to summarise its  
contents, because the ambiguous prose I quote suggests that a parent  
details element is optional).

Can we remove this ambiguity? "The summary element represents an optional  
summary, caption, or legend for the rest of the contents of the summary  
element's parent details element" would work.

bruce

-- 
Using Opera's revolutionary email client: http://www.opera.com/mail/
Received on Tuesday, 20 September 2011 05:49:14 UTC

This archive was generated by hypermail 2.4.0 : Wednesday, 22 January 2020 16:59:36 UTC