W3C home > Mailing lists > Public > public-forms@w3.org > February 2014

Re: New introduction to XForms 2.0

From: Erik Bruchez <erik@bruchez.org>
Date: Tue, 18 Feb 2014 16:49:20 -0800
Message-ID: <CAAc0PEV5RbVQ+U7AP_7AUphNJzyUYRty-wREn86K4B+tL=q99A@mail.gmail.com>
To: Steven Pemberton <Steven.Pemberton@cwi.nl>
Cc: "www-forms@w3.org" <www-forms@w3.org>, "public-xformsusers@w3.org" <public-xformsusers@w3.org>, Forms WG <public-forms@w3.org>
Steven,

Sorry not to have done this sooner, but I have now reviewed the intro.
My comments/corrections below:

1. This might be personal, but I don't like much the use of "XForm" as
a countable thing, as in "an XForm", "some XForms". I would prefer
talking about a "form", and "some forms", as it is clear what we are
talking about here.

2. I am not sure that it helps to mention "Experience has shown […]
order of magnitude". I would rather leave this out (or that would call
for a "citation needed"), as whether true or not it does sound like a
marketing message.

3. Typo: "manipulted → "manipulated".

4. `<itemset nodeset="...">`: should now be `<itemset ref="...">`.

5. "As the name suggests": not sure how the name suggests "Web" forms?
To me it would suggest "XML" forms ;)

6. A big issue with XForms 1.1 and earlier is how you deal with
calculations on currency values, as there was no decimal type (answer:
they work on doubles and produce funny results at times). So in the
example that shows `calculate="../unitprice * ../howmany"`, there
should be a `bind` assigning a `decimal` type to `unitprice`. This is
now possible out of the box with the use or XPath 2 and type
annotations.

That's it for now!

-Erik

On Wed, Feb 12, 2014 at 8:34 AM, Steven Pemberton
<Steven.Pemberton@cwi.nl> wrote:
> Dear XForms users,
>
> I have rewritten the introduction to XForms for the XForms 2.0 spec and
> would appreciate any comments you might have.
>
> http://www.cwi.nl/~steven/forms/intro.html
>
> I have tried to simplify it. Are there any features that don't get mentioned
> that ought to be?
> Are there things mentioned that don't need to be?
>
> Thanks for any help.
>
> Steven Pemberton
>
Received on Wednesday, 19 February 2014 00:50:11 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 21:14:09 UTC