Bug 871222 - [ja_JP] Test case failure: Disk Tab: Remove Disk(s) dialog: "[disk-alias] is Bootable and Attached to [n] VM(s)" message structure need to be revised.
Summary: [ja_JP] Test case failure: Disk Tab: Remove Disk(s) dialog: "[disk-alias] is ...
Keywords:
Status: CLOSED CURRENTRELEASE
Alias: None
Product: Red Hat Enterprise Virtualization Manager
Classification: Red Hat
Component: ovirt-engine-webadmin-portal
Version: 3.1.0
Hardware: Unspecified
OS: Linux
high
urgent
Target Milestone: ---
: 3.2.0
Assignee: Shahar Havivi
QA Contact: Yuko Katabami
URL:
Whiteboard: ux
Depends On:
Blocks: 889232 894497 915537
TreeView+ depends on / blocked
 
Reported: 2012-10-30 00:18 UTC by Yuko Katabami
Modified: 2013-06-11 09:44 UTC (History)
12 users (show)

Fixed In Version: sf1
Doc Type: Bug Fix
Doc Text:
Clone Of:
: 883910 889232 (view as bug list)
Environment:
Last Closed:
oVirt Team: ---
Target Upstream Version:
Embargoed:


Attachments (Terms of Use)
reformat remove disk message (122.09 KB, image/png)
2012-11-07 13:23 UTC, Shahar Havivi
no flags Details
screen-shot: Remove Disk dialog with updated messages (60.78 KB, image/png)
2012-11-09 18:03 UTC, Einav Cohen
no flags Details
Remove Disk dialog (50.40 KB, image/png)
2013-01-09 02:53 UTC, Lijun Li
no flags Details

Description Yuko Katabami 2012-10-30 00:18:04 UTC
Filed from caserun (INSERT URL HERE)

Version-Release number of selected component (if applicable):
unspecified

Steps to Reproduce: 
  * Portal should be in other than English Interface


  * Click on Disk tab in portal
  * Select a disk from the list (I picked icssi-d_Disk1)
  * Click on "Remove" button to open Remove Disk(s) window.
  * It contains message Note: icssi-d_Disk1 is Bootable and Attached to 1 VM(s)



Actual results: 
Japanese translation of that message is: 
注: icssi-d_Disk1 は  ブート可能および仮想マシン 1 台にアタッチ です。
This does not make sense. 
It is because of the string "Note: {0} is {1}" 
It seems that "{0} = icssi-d_Disk1"  which if fine, but
"{1} = Bootable and Attached to 1 VM(s)" This is too complicated to fit in this simple syntax. Verb has to be changed depending on what is placed in {1}. A full sentense without variable must be provided for translation, otherwise it will not make sense at all.
Expected results:
  注: icssi-d_Disk1 は ブート可能かつ仮想マシン 1 台にアタッチされています。

Comment 1 Einav Cohen 2012-11-04 17:45:53 UTC
code logic currently forces the structure, using localized "sentence-particles".
need a solution that will includue localizing full sentences, insead of "sentence-particles", as grammer of each locale is different, and requires a different sentence structure.

Comment 2 Einav Cohen 2012-11-05 16:43:12 UTC
Derez came up with a solution that will have both code logic and ux reasonable:

Instead of having a potentially long and complex message for each disk, e.g.:
"Note: 
    * Disk1 is Bootable and Shareable and Attached to 2 VM(s) other than VM1
    * Disk2 is Bootable
    * Disk3 is Shareable and Attached to 4 VM(s) other than VM1
    * ..."

We can have a small set of short, simple messages, so dialog will contain something like:

"Note:
    * Disk1 is Bootable
    * Disk1 is Shareable
    * Disk1 is Attached to 2 VM(s) other than VM1
    * Disk2 is Bootable
    * Disk3 is Shareable
    * Disk3 is Attached to 4 VM(s) other than VM1
    * ..."

This will prevent the need to hold/localize all possible permutations of sentences that contain (or not) "bootable", "shareable", "attached to x VMs", etc., therefore code logic will be much more simple and easily-maintainable.

ux-wise: although in some aspects this is less user-friendly, short messages like this are also more "easily-digestable" and there is less of a chance that the user will miss an important detail about a certain disk.

Simon - any objection to proceed with the suggestion above?

Comment 3 Simon Grinberg 2012-11-05 18:52:29 UTC
(In reply to comment #2)
 
> "Note:
>     * Disk1 is Bootable
>     * Disk1 is Shareable
>     * Disk1 is Attached to 2 VM(s) other than VM1
>     * Disk2 is Bootable
>     * Disk3 is Shareable
>     * Disk3 is Attached to 4 VM(s) other than VM1
>     * ..."

Why not

"Note:
      * Disk one is:
        Bootable
        Shareable
        Attached to 2 VM(s) other than VM1
      * Disk two is:
        Bootable 
Etc....

Isn't that even shorter and does not look repetitive    

> 
> Simon - any objection to proceed with the suggestion above?

I'm fine if you take Derez suggestion if mine is more complex to implement.

Comment 4 Einav Cohen 2012-11-06 21:21:07 UTC
After checking with all relevant people, we are going with Simon's suggestion in Comment #3.

That means that the localized strings would be as follows:

    @DefaultMessage("Note:")
    String diskNote();

    @DefaultMessage("{0} is:")
    String diskIs(String diskAlias);

    @DefaultStringValue("Shareable")
    String shareable();

    @DefaultStringValue("Bootable")
    String bootable();

    @DefaultMessage("Attached to {0} VM(s) other than {1}")
    String diskAttachedToOtherVMs(int numberOfVms, String vmName);

    @DefaultMessage("Attached to {0} VM(s)")
    String diskAttachedToVMs(int numberOfVms);

And code logic in the GUI should change in order to eventually construct a message like Simon's suggesed in Comment #3.

Comment 5 Shahar Havivi 2012-11-07 13:23:59 UTC
Created attachment 640062 [details]
reformat remove disk message

Added screenshot for the patch solution

Comment 6 Shahar Havivi 2012-11-07 13:25:00 UTC
posted at: http://gerrit.ovirt.org/#/c/9101/

Comment 7 Einav Cohen 2012-11-08 20:42:51 UTC
My original thought was that the dialog content will be structured as follows:

"
   are you sure you want to remove the following disk(s)?

   - disk1
   - disk2
   - disk3
   - disk4

   Note:
   -----
     - disk1 is:
        * shareable
        * bootable
        * attached to 1 VM(s)

     - disk3 is:
        * shareable
"

Apparently, the "Note"s are "embedded" within the list of items to be removed, and not separated from them, like this:

"
   are you sure you want to remove the following disk(s)?

   - disk1
    Note:
     disk1 is:
       shareable
       bootable
       attached to 1 VM(s)

   - disk2

   - disk3
    Note:
       disk3 is:
         shareable

   - disk4
"

It actually makes sense to embed the Notes witihn the items to be removed.

However, in this case:
- there is no need to mention the disk alias again within the Note.
- No real need to separate the "Note:" and the "[disk-alias] is:" parts.

So it would make more sense that the dialog text will be structured as follows:

"
   are you sure you want to remove the following disk(s)?

   - disk1
     Note that the disk is:
       shareable
       bootable
       attached to 1 VM(s)

   - disk2

   - disk3
     Note that the disk is:
       shareable

   - disk4
"

Comment 8 Einav Cohen 2012-11-08 20:56:04 UTC
Hi Yuko,

Will it be OK (grammar-wise in the different locales) if the messages for translation would be:

- Note that the Disk is:
- Shareable
- Bootable
- Attached to {0} VM(s) other than {1}  // {0} : number of VMs, {1} : VM name

to eventually form a dialog message that would look something like:

"
   are you sure you want to remove the following disk(s)?

   - disk1
     Note that the Disk is:
       Shareable
       Bootable
       Attached to 1 VM(s) other than VM2

   - disk2

   - disk3
     Note that the Disk is:
       shareable

   - disk4
"

[this is instead of the suggested following strings that we have discussed before to eventually form something like Simon's suggestion in Comment #3:

- Note:
- {0} is:                               // {0} : Disk Alias
- Shareable
- Bootable
- Attached to {0} VM(s) other than {1}  // {0} : number of VMs, {1} : VM name
]

(see comment #7 for a some background for the change, if you want)
Thanks.

Comment 9 Yuko Katabami 2012-11-09 02:49:35 UTC
Hi Einav,

I checked with other language translators and confirmed that following langs have no problems with the change you are making: br-PT, fr-FR, es-ES, 
de-DE, and ja-JP

Unfortunately zh-CH translator is not available today. I need to confirm this with her on Monday. Sorry to hold you up.

Comment 10 Shahar Havivi 2012-11-09 10:50:51 UTC
new patch sent with the following format
   - disk1
     Note that the Disk is:
       Shareable
       Bootable

Comment 11 Einav Cohen 2012-11-09 18:03:52 UTC
Created attachment 641728 [details]
screen-shot: Remove Disk dialog with updated messages

Comment 12 Einav Cohen 2012-11-09 18:07:08 UTC
You can see the updated dialog content structure in attachment 641728 [details].
Looks much better.

Comment 13 Yuko Katabami 2012-11-12 00:39:21 UTC
Confirmed with the Simplified Chinese translator that the new format works with zh-CH as well. Thanks.

Comment 16 Einav Cohen 2012-12-20 15:03:52 UTC
this bug was cloned to the localization team: bug 889232.

bug 889232 should track the translation of the "remove disk" dialog strings, that were modified as part of this bug fix.

Comment 17 Einav Cohen 2012-12-20 15:04:33 UTC
QA: This bug is only about checking (in English only!) that the messages structure in the "remove disk" dialog has changed to be as follows:

"
   are you sure you want to remove the following disk(s)?

   - disk1
     Note that the Disk is:
       Shareable
       Bootable
       Attached to 1 VM(s) other than VM2

   - disk2

   - disk3
     Note that the Disk is:
       shareable

   - disk4
"

The non-English strings change will be tracked/tested in the context of the cloned BZ - Bug 889232.

Comment 18 Lijun Li 2013-01-09 02:52:40 UTC
Verified on the latest rhevm3.2 sf build, it's fixed.
[root@rhevm32 ~]# rpm -q rhevm rhevm-webadmin-portal
rhevm-3.2.0-4.el6ev.noarch
rhevm-webadmin-portal-3.2.0-4.el6ev.noarch

Messages structure in the "remove disk" dialog has been changed to as #c17

Please refer to the attached screen shot.

Thanks,
Robert

Comment 19 Lijun Li 2013-01-09 02:53:39 UTC
Created attachment 675180 [details]
Remove Disk dialog

Comment 20 Itamar Heim 2013-06-11 09:21:19 UTC
3.2 has been released

Comment 21 Itamar Heim 2013-06-11 09:44:07 UTC
3.2 has been released


Note You need to log in before you can comment on or make changes to this bug.