W3C home > Mailing lists > Public > xmlp-comments@w3.org > January 2003

Minor comments for SOAP CR Parts 1 and 2

From: Susan Lesch <lesch@w3.org>
Date: Sun, 26 Jan 2003 19:41:51 -0800
Message-Id: <p05111b00ba5a570dce4b@[192.168.123.158]>
To: xmlp-comments@w3.org

Hello,

Belated congratulations on your SOAP Version 1.2 Candidate
Recommendation. I think it is beautifully done. Here are minor
comments that apply to both Parts 1 and 2 [1,2].

The files would be 10% smaller if run through HTML Tidy with indent off.
http://tidy.sourceforge.net/

Please remove this CSS rule to fix display in Mac IE and Opera:

     dt.label       { display: run-in; }

It looks like this HTML was generated with an old version of the
xmlspec XSLT stylesheet. To see one reason why, see the Mac IE screen
shot at http://www.w3.org/2003/01/26-soap1.png. This rule also makes
references markup fragile (doesn't apply to what you have right now).

Does this rule come from the xmlspec XSLT?

     li, p           { margin-top: 0.3em;
                      margin-bottom: 0.3em; }

I would omit it because optimal vertical spacing is font-dependent and
W3C CSS says only that TRs are "sans-serif" with unknown metrics. If it
did come from that stylesheet please let me know so it can be reported.

The tables need summary attributes to meet WCAG 1.0 Level A (required).
http://www.w3.org/TR/1999/WAI-WEBCONTENT-19990505/#gl-table-markup

 From Status of This Document:

s/Recommandation/Recommendation/
s/W3C members/W3C Members/
s/W3C membership/W3C Membership/
s/progress."A/progress." A/
s[XML InfoSet]/[XML Infoset]/

References should be written like these (I should note this section may
change): http://www.w3.org/2001/06/manual/#References

 From Acknowledgments:

s/Members of the Working Group/Participants in the Working Group/
(see http://www.w3.org/Consortium/Process-20010719/groups.html)
s/Tibco/TIBCO/
s/Mitre/MITRE/
s/Previous members/Previous participants/
s/(EDF (Electricite de France))/(EDF [Electricit&eacute; de France])/
s/Hewlett Packard/Hewlett-Packard/
s/Developmentor/DevelopMentor/

[1] http://www.w3.org/TR/2002/CR-soap12-part1-20021219/
[2] http://www.w3.org/TR/2002/CR-soap12-part2-20021219/

Best wishes for your project,
-- 
Susan Lesch           http://www.w3.org/People/Lesch/
mailto:lesch@w3.org               tel:+1.858.483.4819
World Wide Web Consortium (W3C)    http://www.w3.org/
Received on Sunday, 26 January 2003 22:42:27 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 27 October 2009 08:42:28 GMT