Improve dialog when PDF wants to open in presentation mode
ClosedPublic

Authored by ngraham on Jan 6 2018, 5:14 AM.

Details

Summary

BUG: 388511

  • Describe what's actually going to happen if you answer in the affirmative
  • Use expressive button text with standard ok/cancel style icons
  • Remove tooltips, since they're not needed when the buttons clearly indicate what will happen when you press them
Test Plan

New dialog:

Both buttons still work to do what they say they'll do.

Diff Detail

Repository
R223 Okular
Branch
master
Lint
No Linters Available
Unit
No Unit Test Coverage
ngraham created this revision.Jan 6 2018, 5:14 AM
Restricted Application added a project: Okular. · View Herald TranscriptJan 6 2018, 5:14 AM
ngraham requested review of this revision.Jan 6 2018, 5:14 AM
rkflx requested changes to this revision.Jan 6 2018, 7:49 AM

You should open a 48h bugfixing service ;)

Example PDF (via https://tex.stackexchange.com/a/219791):

part.cpp
1626–1627

While testing, I thought "The last sentence should be on a new line", because a narrower dialog would be easier to read. And indeed, looking at the code there was a line break before. Please keep it.

1628

Why not just Cancel? Seems more common to me.

Perhaps use KStandardGuiItem::cancel() and manually setToolTip()?

This revision now requires changes to proceed.Jan 6 2018, 7:49 AM
ngraham updated this revision to Diff 24844.EditedJan 6 2018, 5:34 PM
  • Returned to using a multi-line string
  • Updated wording
  • Made button text more expressive
  • Used standard ok/cancel style icons for buttons
ngraham retitled this revision from Improve message displayed when PDF wants to open in presentation mode to Improve dialog when PDF wants to open in presentation mode.Jan 6 2018, 5:35 PM
ngraham edited the test plan for this revision. (Show Details)
ngraham marked an inline comment as done.
ngraham added inline comments.
part.cpp
1628

I considered that, but that button doesn't actually cancel anything; it just doesn't do the proposed action.

ngraham updated this revision to Diff 24845.Jan 6 2018, 5:39 PM

With expressive buttons, we don't need explanatory tooltips amymore

ngraham edited the summary of this revision. (Show Details)Jan 6 2018, 5:40 PM
rkflx added a comment.EditedJan 6 2018, 5:44 PM

Now we have "Presentation Mode" (title), "Presentation Mode" (first sentence), "Presentation Mode" (second sentence), "Presentation Mode" (button). I find it a bit annoying to read ;) Can we do something about it, e.g. by removing the second sentence? Any other idea?

(Nice idea with the "Stay here").

Good point, that is too many presentation modes.

rkflx added a comment.Jan 6 2018, 5:53 PM

Yep. Take your time with rephrasing, it's 18.04 material anyway. Also, it should probably stay being a question (because it's not a warning or information either), hence the question mark icon.

rkflx added a comment.Jan 6 2018, 5:55 PM

(Helps saving inline comments before pressing "Submit").

part.cpp
1627–1631

Title Case for buttons, IIRC?

How about this?

rkflx added a comment.Jan 6 2018, 6:27 PM

How about this?

It's is an innovative idea, but unless there are any other existing examples putting the question in the title, I'm afraid I would not recommend to do this here.

Maybe something with "Honor the request ... allow to ... to be shown ... switch to ... fullscreen...?"? This way we would rephrase the term Presentation Mode a bit for anyone not knowing what it means. On the other hand, the real fullscreen mode is different again. But perhaps you can take it from here.

Another idea: Say where we are switching from. Or simply ask whether the user allows to switch modes at all (with the actual mode only in the title and on the button).

OK, maybe something more like this?

rkflx added a comment.Jan 6 2018, 10:42 PM

Sounds great. Maybe "View Mode" in the title? ("Mode" is not really meaningful in itself.)

Also: Title Case in title, I guess?

Do you think Albert should approve this?

More polish:

I try to add Albert as a reviewer for Okular patches since he is/was/has been a maintainer.

rkflx added a comment.Jan 6 2018, 10:50 PM

That's even better. Just update the Diff, I'll check / approve and then we'll see what Albert says.

ngraham updated this revision to Diff 24855.Jan 6 2018, 10:51 PM
ngraham edited the summary of this revision. (Show Details)

Polish and UI review

ngraham marked 3 inline comments as done.Jan 6 2018, 10:51 PM
ngraham edited the test plan for this revision. (Show Details)
rkflx accepted this revision.Jan 6 2018, 10:56 PM

Thanks, Nate!

@aacid Are you okay with this change?

This revision is now accepted and ready to land.Jan 6 2018, 10:56 PM
aacid added a comment.Jan 7 2018, 12:01 AM

Honestly I'm not thrilled with "Stay Here", though I'm not a native English speaker either.

I think that Keep would be a better verb than Stay and "Here" is kind of weird since this dialog will most likely open when you open a file, so most probably you didn't even have Okular open yet, so what is "Here"?

One obvious solution is "Do not enter presentation mode", but that's probably too similar word wise and may be confusing then there's "Keep Regular View Mode" or something similar.

I wasn't 100% sold on "Stay Here" either, but it was the best I could come up with at the time. That said, Okular's main window is definitely visible by the time the dialog shows up, so "here" would visually refer to that.

How about this?

rkflx added a comment.Jan 7 2018, 12:16 AM

What is Normal Mode to the user, anyway? It's not bad, but does not click with me immediately, TBH.

How about Deny Request? That would correspond nicely with the title.

aacid added a comment.Jan 7 2018, 11:31 AM

I guess i'm ok with that.

ngraham updated this revision to Diff 24882.Jan 7 2018, 3:06 PM

Tweaks according to review comments

ngraham edited the test plan for this revision. (Show Details)Jan 7 2018, 3:06 PM

OK to land this now? And if so, onto master or Applications/17.12?

aacid added a comment.EditedJan 7 2018, 4:30 PM

You can not change translatable text in a stable branch unless the source English text is clearly broken and will lead to horrible things happening. And this is not one of those cases by far.

OK, so master, then, thanks. Can I land this?

rkflx added a comment.Jan 7 2018, 6:47 PM

I think so. Thanks for all the tweaks, BTW.

ngraham closed this revision.Jan 7 2018, 6:49 PM