Re: Proposed W3C Spec Conventions

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 UTC