[OASIS Issue Tracker] Commented: (OFFICE-3462) 19.310form:step-size and 19.300 form:page-step-size ill-defined

[OASIS Issues Tracker <workgroup_mailer@lists.oasis-open.org>]

    [ http://tools.oasis-open.org/issues/browse/OFFICE-3462?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=21930#action_21930 ] 

Dennis Hamilton commented on OFFICE-3462:
-----------------------------------------

I see this is applied, but I have no idea which alternative you chose (although I suspect your preference is "a").

I have figured out what bothers me about that.

Whenever I see an indefinite article in a specification provision, such as "an X" my mind immediately goes to the question, "which X?"  Some random one,  some out of sight, etc.

When I see "the X" I assume we are talking about the particular instance of X that is associated with an instance of an element or attribute being described.  Something more in-context.

In this particular case, I think "the UI" is meant to be "the user-interface of the OpenDocument Consumer by which the form interaction is presented."

I also note, in thinking about this particular case from that perspective, that we are talking about "the preferred [small/large] step among value choices to be easily chosen when supported by the OpenDocument Consumer user-interface, if any, for interaction with the control."

Just noticing ...

> 19.310 form:step-size and 19.300 form:page-step-size ill-defined
> ----------------------------------------------------------------
>
>                 Key: OFFICE-3462
>                 URL: http://tools.oasis-open.org/issues/browse/OFFICE-3462
>             Project: OASIS Open Document Format for Office Applications (OpenDocument) TC
>          Issue Type: Bug
>          Components: Forms, Part 1 (Schema)
>    Affects Versions: ODF 1.2 CD 05
>            Reporter: Dennis Hamilton
>            Assignee: Patrick Durusau
>             Fix For: ODF 1.2 CD 06
>
>
> The form:page-step-size and form:step-size attributes are not defined well enough to understand their function.  
> These appear to be involved with regard to stepping through values as part of UI activity in which the value is chosen.   The analogy of form:page-step-size with "page down" functionality means something different depending on whether there is a drop-down of values offered versus whether the value in a spinner is being adjusted.  
> Since these attributes are only used for <form:value-range>, maybe they need to be descibed better in terms of what their (optional) functionality is for such a control.  I have no objection to change to double, but we also need to know what these are provided for and whether they are intended as constraints or simply aids for assisting users in selecting/entering a value.
> See also OFFICE-3412 where there is a related issue.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators: http://tools.oasis-open.org/issues/secure/Administrators.jspa
-
For more information on JIRA, see: http://www.atlassian.com/software/jira