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

Re: Proposed W3C Spec Conventions

From: Ian Hickson <ian@hixie.ch>
Date: Wed, 17 Feb 2010 21:11:27 +0000 (UTC)
To: Doug Schepers <schepers@w3.org>
Cc: Anne van Kesteren <annevk@opera.com>, Spec Prod <spec-prod@w3.org>, Geoffrey Sneddon <gsneddon@opera.com>
Message-ID: <Pine.LNX.4.64.1002172108290.2088@ps20323.dreamhostps.com>
On Wed, 17 Feb 2010, Doug Schepers wrote:
> > > 
> > >  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>
> > 
> > In the source (before running anolis) this would just be:
> > 
> >     <code>foo</code>
> > 
> > ...because the title="" can be omitted if it matches the element's
> > textContent.
> 
> Makes sense.
> 
> 
> > >   <a href="#bar-attribute" title="attr-foo-bar><code
> > > class="attr">bar</code></a>
> > 
> > This would just be:
> > 
> >     <code title="attr-foo-bar">bar</code>
> > 
> > Anolis takes care of making all the cross-references (<a>s).
> 
> Right.  I'm most interested (for this document) in the resulting markup,
> rather than the tool-specific inputs.

Ah, ok.

For the first:

   <code><a href=#autogeneratedid>body</a></code>

For the second:

   <code title=attr-foo-bar><a href=#autogeneratedid2>bar</a></code>

The auto-generated IDs should probably have some correlation with the text 
near the corresponding <dfn>, so as to be more stable; for example, using 
the "title" attribute if there is one.

-- 
Ian Hickson               U+1047E                )\._.,--....,'``.    fL
http://ln.hixie.ch/       U+263A                /,   _.. \   _\  ;`._ ,.
Things that are impossible just take longer.   `._.-(,_..'--(,_..'`-.;.'
Received on Wednesday, 17 February 2010 21:11:56 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Saturday, 10 March 2012 06:19:16 GMT