W3C home > Mailing lists > Public > public-sml@w3.org > July 2007

[w3c sml] Action 89 (was: [minutes] [ver 2] 2007-06-28 SML Teleconference)

From: Sandy Gao <sandygao@ca.ibm.com>
Date: Thu, 5 Jul 2007 09:27:23 -0400
To: public-sml@w3.org
Message-ID: <OFDE063BD3.A072DBB1-ON8525730F.00473A95-8525730F.0049EB9A@ca.ibm.com>

A few comments/observations on "Action 89 - presenting summary changes in 
draft documents".

> agreed to do a simple xml diff on the draft versions and
> apply a stylesheet to create the highlights

This may be sufficient. It's simpler than how schema does it (where markup 
and stylesheets are heavily involved).

But the drawback is it's no as easy to "group/adopt/reject" changes. For 
example, it'd be nice to be able to say, these 5 changes are for issue 
ABC, and those 10 are for XYZ. Then the WG can adopt ABC changes but 
reject XYZ. Or the WG can adopt 3 ABC changes, reject the other 2, and 
maybe add another 3. With markup, all these can be done by simply changing 
some flags. With XML diff, the editors need to be extremely careful when 
implementing WG decisions.

I'm not suggesting that we should switch to schema's model. Just want to 
point this out in case people haven't thought about it.

Ginny posted a draft recently. It was very useful to have the diffs.

One thing I never understood was how the "changed text" (green) was 
supposed to be used in schema. It's not used in recent schema 
proposals/drafts. Seems SML also has the same idea. Can someone explain 
when "green" should be used instead of yellow/red?

Can we use a softer color than red? It hurts people's eyes if long 
paragraphs are deleted.

To make it easy to locate changes, it'd be nice to start changes with some 
common symbol. Schema uses up/down arrows to indicate addition/deletion. 
The problem there is that popular browsers don't support "search for 
EITHER up OR down arrow". Maybe SML can start all additions with, say, 
"|?" and end them with "?". Start all deletions with "|?" and end them 
with "?"? (I stole this idea from MSM, who recently suggested it to the 
schema WG.)

This would also make our documents more accessible, as not everyone is 
sensitive to colors.

Sandy Gao
XML Technologies, IBM Canada
Editor, W3C XML Schema WG
Member, W3C SML WG
(1-905) 413-3255 T/L 969-3255

John Arwe <johnarwe@us.ibm.com> 
Sent by: public-sml-request@w3.org
2007-06-29 12:00 PM


[w3c sml] [minutes] [ver 2] 2007-06-28 SML Teleconference

[ver 2] : add updated scribe list, remove errant c/foo/bar/ output, 
correct spelling of Virginia's nickname (all problems noted via offline 
emails), tagged email subject as documented for easily archive searches 

FYI, editing minutes with some packages, like Word, lead to undesireable 
results like removal of w3c css refs.  Take a look at the html output 
before deciding you like what it did visually :-) 

Best Regards, John

Street address: 2455 South Road, Poughkeepsie, NY USA 12601
Voice: 1+845-435-9470      Fax: 1+845-432-9787

#### 20070628-sml-minutes.html has been removed from this note on July 05 
2007 by Sandy Gao
Received on Thursday, 5 July 2007 13:27:46 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 17:24:15 UTC