W3C home > Mailing lists > Public > public-webplatform@w3.org > January 2014

Re: Documenting ITS 2.0 attributes at WPD

From: Jirka Kosek <jirka@kosek.cz>
Date: Wed, 15 Jan 2014 13:45:39 +0100
Message-ID: <52D682F3.9000508@kosek.cz>
To: Doug Schepers <schepers@w3.org>
CC: Julee <julee@adobe.com>, "public-webplatform@w3.org" <public-webplatform@w3.org>
On 13.1.2014 18:31, Doug Schepers wrote:
> 1) Wrap the example in 'syntaxhighlight' tags:
> 
> <syntaxhighlight>
>   <p>We need a new <span its-term=yes>motherboard</span></p>
> </syntaxhighlight>

Thanks, this indeed helps.

> Also, for the live link examples, we prefer you link to the example in
> WPD itself, so readers can see what's going on and so the content
> doesn't get lost,

Examples to which I pointed are living in /TR/ space in W3C servers so
they are likely more stable then WPD :-)

I don't mind copying over examples to dabblet, but it doesn't make much
sense for ITS -- ITS markup is usually processed in background by
translation tools, thus it is very unlikely that someone will directly
decorate it with CSS or manipulate it with JS.

> I have a few more suggestions for you about this page, but I'll hold
> those to another email. Basically, I had a hard time figuring out (from
> that page or from the spec) what 'its-term' is for. I think you need to
> be a lot more explicit for beginners in the summary,

I addded little bit more explanation

> and add the missing
> context pages:
> 
> http://docs.webplatform.org/wiki/its/attributes
> http://docs.webplatform.org/wiki/its

I added those, although with just skeletonal content for now.

> I hope that helps!

Indeed, appreciated.

				Jirka

-- 
------------------------------------------------------------------
  Jirka Kosek      e-mail: jirka@kosek.cz      http://xmlguru.cz
------------------------------------------------------------------
       Professional XML consulting and training services
  DocBook customization, custom XSLT/XSL-FO document processing
------------------------------------------------------------------
 OASIS DocBook TC member, W3C Invited Expert, ISO JTC1/SC34 rep.
------------------------------------------------------------------
    Bringing you XML Prague conference    http://xmlprague.cz
------------------------------------------------------------------


Received on Wednesday, 15 January 2014 12:46:13 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:20:57 UTC