Re: XForms expression module diff version

This looks great, Nick.
It is a little hard to tell whether green versus yellow means change 
versus add (the norm for W3C) or whether green means add and yellow means 
change (the norm for normal people who relate the color to what has 
conceptually happened).
For example, the eval() and eval-in-context() shows up mostly green, but 
it is added content, not changed content.  Functions like parse and 
serialize are added, but are yellow.  Similarly, the pre-existing examples 
in adjust-dateTime-to-timezone() have added words that showed up in green, 
and a whole new example that showed up yellow.
Again, I don't think the distinction matters much since an addition is 
just a special kind of change, and so having color in the right places is 
what's important, and so I think it's good to go.  If you're showing diffs 
relative to 1.1 content, then maybe the diff marking around the editors 
seems reversed :-)

Not to do with this document in particular, but I'm surprised W3C still 
let's red and green be used for diff marking, given emphasis on 
accessibility.

Cheers,
John M. Boyer, Ph.D.
Distinguished Engineer, IBM Forms and Smarter Web Applications
IBM Canada Software Lab, Victoria
E-Mail: boyerj@ca.ibm.com 

Twitter: http://twitter.com/johnboyerphd
Blog: http://www.ibm.com/developerworks/blogs/page/JohnBoyer
Blog RSS feed: 
http://www.ibm.com/developerworks/blogs/rss/JohnBoyer?flavor=rssdw





From:   Nick Van den Bleeken <Nick.Van.den.Bleeken@inventivegroup.com>
To:     Public Forms <public-forms@w3.org>
Date:   24/05/2012 02:30 AM
Subject:        XForms expression module diff version



All, 

I managed to re-create a base version for the XForms Expression module and 
use this as a base for the diff version. I decided to not mark the change 
in notation of the function attributes as a change, because this isn't a 
real change but only a syntax change.

You can find the live diff version at 
http://www.w3.org/2007/10/htmldiff?doc1=http%3A%2F%2Fwww.w3.org%2FMarkUp%2FForms%2Fwiki%2FXPath_Expressions_Module_base&doc2=http%3A%2F%2Fwww.w3.org%2FMarkUp%2FForms%2Fwiki%2FXPath_Expressions_Module 
any changes made to wiki spec will be reflected in the diff version.

Could all group members have a look at the differences and decide if they 
agree with those changes so we can advance this document and the XForms 
core document to FPWD.

Thanks in advance,

Nick Van den Bleeken
R&D Manager

Phone: +32 3 425 41 02
Office fax: +32 3 821 01 71
nick.van.den.bleeken@inventivegroup.com
www.inventivedesigners.com

PS: I'm not completely happy with the diff marking (e.g.: the eval 
functions sections), but this is the best I could get it. Also be warned 
that the coloring schema isn't what you would expect (change: yellow, 
new:lime), for the FPWD version we can change the colors in the css if we 
want to. 



Inventive Designers' Email Disclaimer:
http://www.inventivedesigners.com/email-disclaimer