W3C home > Mailing lists > Public > spec-prod@w3.org > January to March 2010

Re: Proposed W3C Spec Conventions

From: Doug Schepers <schepers@w3.org>
Date: Tue, 09 Mar 2010 18:19:13 -0500
Message-ID: <4B96D771.7020300@w3.org>
To: Geoffrey Sneddon <gsneddon@opera.com>
CC: Anne van Kesteren <annevk@opera.com>, Spec Prod <spec-prod@w3.org>, Ian Hickson <ian@hixie.ch>
Hi, gsnedders-

Geoffrey Sneddon wrote (on 3/9/10 10:35 AM):
> On 17/02/10 20:07, Doug Schepers wrote:
>>> For terms we use <dfn> but we use the title attribute as well to provide
>>> detail, more or less per these rules:
>>>  [...]
>> What's the example usage here? Like, for @bar of <foo>, is this right?
>> <a href="#foo-element" title="foo"><code class="element">foo</code></a>
>> <a href="#bar-attribute" title="attr-foo-bar><code
>> class="attr">bar</code></a>
>> Seems reasonable to me, if a bit terse.
> If we're not interested in tool-input markup, what's the interest of the
> title attribute here?

If the only use for @title is for the input format, then I'm not 
particularly interested in it for the Spec Conventions document, which 
is about the output conventions.

That said, this might be useful for other spec generation tools, like 
ReSpec, DocBook+XSLT, or XMLSpec.  Perhaps that's what Anne was 
suggesting, and I can see the benefits.

-Doug Schepers
W3C Team Contact, SVG and WebApps WGs
Received on Tuesday, 9 March 2010 23:19:16 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:42:18 UTC