After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 727960 - Game buttons - replace icons with labels
Game buttons - replace icons with labels
Status: RESOLVED FIXED
Product: gnome-mines
Classification: Applications
Component: general
3.12.x
Other Linux
: High enhancement
: ---
Assigned To: gnome-mines-maint
gnome-mines-maint
available
Depends on:
Blocks: 727961
 
 
Reported: 2014-04-10 12:39 UTC by Allan Day
Modified: 2014-04-18 14:41 UTC
See Also:
GNOME target: ---
GNOME version: 3.11/3.12


Attachments
Improvements to the buttons area (4.25 KB, patch)
2014-04-15 12:43 UTC, Robert Roth
reviewed Details | Review
Additional patch (5.93 KB, patch)
2014-04-15 21:40 UTC, Robert Roth
reviewed Details | Review
Complete patch (7.84 KB, patch)
2014-04-16 01:11 UTC, Robert Roth
reviewed Details | Review
screenshot, 8x8 mode (22.97 KB, image/png)
2014-04-16 04:13 UTC, Michael Catanzaro
  Details
Updated complete patch (10.31 KB, patch)
2014-04-16 07:42 UTC, Robert Roth
none Details | Review
Updated buttons to match the mockups (10.20 KB, patch)
2014-04-16 23:23 UTC, Michael Catanzaro
accepted-commit_now Details | Review
Set a reasonable size request for the main window (1.11 KB, patch)
2014-04-17 03:11 UTC, Michael Catanzaro
committed Details | Review
Updated buttons to match the mockups (10.20 KB, patch)
2014-04-17 03:11 UTC, Michael Catanzaro
committed Details | Review
modified screenshot (27.33 KB, image/png)
2014-04-17 13:01 UTC, Allan Day
  Details
Fix remaining sidebar button issues (4.56 KB, patch)
2014-04-18 01:19 UTC, Robert Roth
committed Details | Review

Description Allan Day 2014-04-10 12:39:52 UTC
The icons used for the hint and restart buttons are quite ambiguous. It would be clearer if they had labels instead:

https://raw.githubusercontent.com/gnome-design-team/gnome-mockups/master/games/mines/mines2-new.png
Comment 1 Robert Roth 2014-04-15 12:43:03 UTC
Created attachment 274362 [details] [review]
Improvements to the buttons area

Improvements:
* clock label separated from pause/resume button
* pause/resume button made text-only
Comment 2 Michael Catanzaro 2014-04-15 19:24:53 UTC
Review of attachment 274362 [details] [review]:

OK, that's not the full design, but I think it's sufficient for the purposes of this bug. But can you please rename the label from Start to New Game -- this makes it less confusing that it takes you to the new game screen.

Also, I think these buttons should also have accelerators (access keys - for when holding down Alt).
Comment 3 Robert Roth 2014-04-15 20:33:48 UTC
(In reply to comment #2)
Thanks for the quick review.
> Review of attachment 274362 [details] [review]:
> 
> OK, that's not the full design, but I think it's sufficient for the purposes of
> this bug. 
Yes, there are plenty of bugs discussing the new design, I will try to tackle each separately, but the patches will probably depend on eachother.
> But can you please rename the label from Start to New Game -- this
> makes it less confusing that it takes you to the new game screen.
Now that you have mentioned, I have tried that button, and that takes me to the difficulty selection screen, so I guess that should be the Change difficulty button (that's the closest one I could think of), as New Game in Allan's mockups doesn't exist, it's rather Play again or Start again for playing with the same difficulty or Change difficuly for selecting another difficulty.
> 
> Also, I think these buttons should also have accelerators (access keys - for
> when holding down Alt).
You've got a point there, adding the accelerators, preparing an updated patch, and I'll submit it for a review as soon as it's ready.
Comment 4 Michael Catanzaro 2014-04-15 21:02:15 UTC
(In reply to comment #3)
> (In reply to comment #2)
> Thanks for the quick review.
> > Review of attachment 274362 [details] [review] [details]:
> > 
> > OK, that's not the full design, but I think it's sufficient for the purposes of
> > this bug. 
> Yes, there are plenty of bugs discussing the new design, I will try to tackle
> each separately, but the patches will probably depend on eachother.

Yeah, it's a bit confusing... but it also helps to have it broken down into little chunks.  I'm actually surprised how little there is left to do, with Allan providing the new icons.

> > But can you please rename the label from Start to New Game -- this
> > makes it less confusing that it takes you to the new game screen.
> Now that you have mentioned, I have tried that button, and that takes me to the
> difficulty selection screen, so I guess that should be the Change difficulty
> button (that's the closest one I could think of), as New Game in Allan's
> mockups doesn't exist, it's rather Play again or Start again for playing with
> the same difficulty or Change difficuly for selecting another difficulty.

Right, this button would eventually become Change Difficulty, but since there is no Play Again button yet it makes sense to just call it New Game for now.  (Or you could add the Play Again button :)
Comment 5 Robert Roth 2014-04-15 21:40:19 UTC
Created attachment 274400 [details] [review]
Additional patch

This patch applied over the previous one updates the buttons to match the latest mockups by hiding/showing them based on the game status.
The suggestions from the previous review have also been implemented, so the buttons now have mnemonics set for easy access.
Comment 6 Michael Catanzaro 2014-04-15 23:25:23 UTC
Review of attachment 274400 [details] [review]:

Looking good.  One problem is that the button layout gets quite confused if the game gets paused before it has started, but that's actually an issue in 3.12 as well, so let's punt that to another bug #728305.

Another problem is that the buttons would look better if they were wider, as shown in the design.  You can fix that now as part of this bug, or we can do so later, I don't mind either way.

::: src/gnome-mines.vala
@@ +200,3 @@
         buttons_box.pack_start (hint_button, false, false, 0);
         size.add_widget (hint_button);
+        hint_button.show_all();

There are a few places in this patch where you miss the space before the opening parenthesis; can you fix those all please?
Comment 7 Michael Catanzaro 2014-04-15 23:33:45 UTC
Hey Allan, Robert implemented you design where the Play Again and Change Difficulty buttons appear when the game is paused.  I think it's a bit confusing that the presence of these buttons depends on whether or not the game is paused -- it'd make more sense to me if they were either always present, or only present after the game is over.
Comment 8 Robert Roth 2014-04-16 01:11:56 UTC
Created attachment 274412 [details] [review]
Complete patch

The previous two patches merged and fixed based on reviews, implementing the button bar as seen in the mockups.
Comment 9 Michael Catanzaro 2014-04-16 04:12:47 UTC
Review of attachment 274412 [details] [review]:

Meh, now 8x8 mode looks pretty bad -- any chance you can figure out what to do about this?  If not, we'll just have to go back to the skinnier buttons for now.

::: src/gnome-mines.vala
@@ +181,3 @@
         buttons_box.margin_right = 15;
         buttons_box.margin_left = 15;
+        buttons_box.set_size_request (140, -1);

How about 100 instead of 140?  This would closer match Allan's design, and I think the buttons are a bit too wide otherwise.

@@ +219,3 @@
+        play_pause_button.hide ();
+
+        high_scores_button = new Gtk.Button.with_mnemonic (_("_Best\nTimes"));

I appreciate the attention to detail, but we're not really supposed to use newlines in translatable strings. The labels would be fine on a single line, but maybe they'll wrap naturally if the buttons were not so wide.
Comment 10 Michael Catanzaro 2014-04-16 04:13:19 UTC
Created attachment 274416 [details]
screenshot, 8x8 mode
Comment 11 Robert Roth 2014-04-16 07:42:15 UTC
Created attachment 274421 [details] [review]
Updated complete patch

Updated based on review:
* removed new lines from translatable strings
* removed minimum size request for buttons-box
* added sane minimum size request (420x420) for the window based on the smallest size the window looks bearable, but still close to the mockup (the best screen to test with is the game lost screen containing three long-texted buttons, and the top button should not overlap the clock)
Comment 12 Michael Catanzaro 2014-04-16 23:23:42 UTC
Created attachment 274536 [details] [review]
Updated buttons to match the mockups

Hm, that looks even worse. :D

I'm not sure what else you changed in that last patch (I guess the icon sizes), but by reverting the last two points, I now have it looking good. Can you please review this new version of the patch to make sure you're OK with it (since it has your name on it)? Thanks!
Comment 13 Robert Roth 2014-04-17 01:05:44 UTC
Review of attachment 274536 [details] [review]:

Looks fine for me, with one minor issue:
* Start 8x8 game
* Resize to minimum size
* pause the game
Expected: the game pauses
What happens: the game pauses and resizes the window vertically
If you're fine with this, it's ok for me, I will come up with a fix for that separately later :)
Comment 14 Michael Catanzaro 2014-04-17 03:09:42 UTC
Eh, turns out the size request wasn't hurting anything, and we can fix that by just setting a larger value.

Con: might not work on themes with really large buttons.
Comment 15 Michael Catanzaro 2014-04-17 03:11:32 UTC
Thanks for iterating on this, Robert!

The following fixes have been pushed:
d7681d8 Set a reasonable size request for the main window
dd11c7d Updated buttons to match the mockups
Comment 16 Michael Catanzaro 2014-04-17 03:11:34 UTC
Created attachment 274556 [details] [review]
Set a reasonable size request for the main window

Otherwise, the window can be resized to excessively small sizes. Besides
being unuseful in its own right, this causes the window to expand when
pausing the game, since pausing the game adds more buttons.
Comment 17 Michael Catanzaro 2014-04-17 03:11:37 UTC
Created attachment 274557 [details] [review]
Updated buttons to match the mockups

* Updated the buttons to match the mockups
* Set a sane minimum size for the window
* Reduce spacing between the new game screen buttons to 18px
Comment 18 Allan Day 2014-04-17 13:01:22 UTC
Created attachment 274599 [details]
modified screenshot

This looks great! Big improvement. I see two issues though:

1. The padding on the buttons could be better. Right now they are too tall, and there isn't enough horizontal space around the labels. I would reduce the height and change "Change Difficulty" to "Difficulty" (see the modified screenshot).

2. When I start a game I see a "Change Difficulty" button on its own. Once I make my first move, it changes to "Pause". This feels a bit odd to take that option away from the user. Also, I've just selected the difficulty - why would I want to then change it again? A better solution (at least to me) would be to start the timer as soon as the game view opens - so you always see "Pause".
Comment 19 Michael Catanzaro 2014-04-17 14:48:19 UTC
1. Yes, all the padding is better in your mockup and in your modified screenshot.

2. I'd prefer for the timer to start as soon as the player makes the first move and not before, like in our other timed games.

What confused me slightly is that the New Game and Change Difficulty options appear while the game is paused; is there any reason for that? I think it'd be less confusing for them to either be available at all times, or else only after the game is over. (Why should the player need to know that pausing the game allows him to start over?)
Comment 20 Robert Roth 2014-04-18 01:19:30 UTC
Created attachment 274639 [details] [review]
Fix remaining sidebar button issues

Fixed various sidebar button issues
    
* Reworded Change Difficulty button to Difficulty
* Added button padding to match the mockups (12 px top and bottom, 24 px left and right)
* Do not show the Difficulty button between game start and timer start
Comment 21 Michael Catanzaro 2014-04-18 14:41:35 UTC
Looks slick, thanks