Bug 161411 - UI Better wording for ASCII-only characters
Summary: UI Better wording for ASCII-only characters
Status: NEW
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Writer (show other bugs)
Version:
(earliest affected)
7.4.0.3 release
Hardware: All All
: medium normal
Assignee: Not Assigned
URL:
Whiteboard:
Keywords: difficultyBeginner, easyHack, skillDesign, topicDesign
Depends on:
Blocks: PDF-Export-Options-Dialog
  Show dependency treegraph
 
Reported: 2024-06-04 07:20 UTC by Gabor Kelemen (allotropia)
Modified: 2024-06-14 09:14 UTC (History)
5 users (show)

See Also:
Crash report or crash signature:


Attachments
Screenshot of the issue (9.42 KB, image/png)
2024-06-04 07:20 UTC, Gabor Kelemen (allotropia)
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Gabor Kelemen (allotropia) 2024-06-04 07:20:40 UTC
Created attachment 194539 [details]
Screenshot of the issue

This is a followup to bug 50400

1. Open a new document
2. File - Export As - Export As PDF
3. Go to the Security tab, press the Set Password button
4. Type some non-ASCII character into the Password field
-> at the bottom of the dialog the warning "Only Basic Latin characters can be entered" appears. This was added in bug 50400

User feedback is that this wording is equally cryptic as just saying ASCII, also does not indicate whether special characters such as  $, %, &, are exempt or not.

Wording needs to be improved, maybe by listing "everything" allowed.

Version: 24.8.0.0.alpha1+ (X86_64) / LibreOffice Community
Build ID: f6ea343e6fb2dc3539823dee60c9c6f96fc16275
CPU threads: 8; OS: Linux 5.15; UI render: default; VCL: gtk3
Locale: hu-HU (hu_HU.UTF-8); UI: en-US
Calc: threaded
Comment 1 Gabor Kelemen (allotropia) 2024-06-04 07:22:15 UTC
asking for UX input as well
Comment 2 Heiko Tietze 2024-06-04 08:59:16 UTC
"Basic Latin" is the name of the code block, https://codepoints.net/basic_latin?lang=en. Not necessarily wrong if you want to avoid the term ASCII or "A..Z,[,{...". 

"Plain Latin characters" could be an alternative but I wonder if users understand that it includes brackets, for example.
Comment 3 Tuomas Hietala 2024-06-04 21:59:44 UTC
Yes, "Basic Latin" is correct in the sense that it's the official name of the Unicode block. But if you don't know it's a name of a Unicode block (and I think most users don't), there's a lot of room for confusion.

"ASCII" is most likely a better known term, because it's been around for longer, but the users who understand it might still be in the minority.

Possible solutions could be the following:

* "Only characters in Basic Latin Unicode block can be entered"
The average user would be none the wiser, but at least interested users could search for "Basic Latin Unicode block" on the internet and discover what it contains.

* "Only ASCII character can be entered"
This would be clear for the more technically oriented users, but not so much for the rest.

* "Only characters A-Z, a-z, 0-9 and the most common punctuation marks can be entered"
Not an exact definition, but would give the right idea to most users, perhaps?

* ""Only Basic Latin (a.k.a. ASCII) characters (A-Z, a-z, 0-9 and the most common punctuation marks) can be entered"
Something for everyone?
Comment 4 V Stuart Foote 2024-06-05 01:28:18 UTC
Unlike the Unicode 'Basic Latin' block, referring to ASCII is a problem as non-standard Extended-ASCII and localized 8-bit character mappings remain prevalent. 

And also utf-8 is broken for password entry as noted in bug 50400--that our SfxPasswordDialog::AllowAsciiOnly() used in pw dialogs exclusively validates the 7-bit 128 character ASCII code set.

That is what needs to be conveyed.

(In reply to Tuomas Hietala from comment #3)
>...
> * ""Only Basic Latin (a.k.a. ASCII) characters (A-Z, a-z, 0-9 and the most
> common punctuation marks) can be entered"
> Something for everyone?

Make that "Only Unicode 'Basic Latin' (a.k.a ASCII) characters (A-Z, a-z, 0-9 and the most common punctuation marks) can be entered"
Comment 5 Heiko Tietze 2024-06-05 08:43:08 UTC
If we end up in a verbose label, I suggest to keep a short label and have the explanatory text in a tooltip.

("aka" might become a migraine for l10n)
Comment 6 Tuomas Hietala 2024-06-11 20:23:10 UTC
(In reply to V Stuart Foote from comment #4)
> Unlike the Unicode 'Basic Latin' block, referring to ASCII is a problem as
> non-standard Extended-ASCII and localized 8-bit character mappings remain
> prevalent. 
> 
> And also utf-8 is broken for password entry as noted in bug 50400--that our
> SfxPasswordDialog::AllowAsciiOnly() used in pw dialogs exclusively validates
> the 7-bit 128 character ASCII code set.
> 
> That is what needs to be conveyed.
> 
> (In reply to Tuomas Hietala from comment #3)
> >...
> > * ""Only Basic Latin (a.k.a. ASCII) characters (A-Z, a-z, 0-9 and the most
> > common punctuation marks) can be entered"
> > Something for everyone?
> 
> Make that "Only Unicode 'Basic Latin' (a.k.a ASCII) characters (A-Z, a-z,
> 0-9 and the most common punctuation marks) can be entered"

Yes, that would be even more complete.
Comment 7 Tuomas Hietala 2024-06-11 20:36:39 UTC
(In reply to Heiko Tietze from comment #5)
> If we end up in a verbose label, I suggest to keep a short label and have
> the explanatory text in a tooltip.
> 
> ("aka" might become a migraine for l10n)

Not sure about the migraine, but of course if we put it in a tooltip, we could as well write "also known as" as we wouldn't be running out of space anyway.

So perhaps something like this:
"Only Unicode 'Basic Latin' characters can be entered"

And the tooltip/explanation:
"Characters in the Unicode 'Basic Latin' block (also known as ASCII) include the letters A-Z, a-z, numbers 0-9 and the most common punctuation marks."
Comment 8 Heiko Tietze 2024-06-14 09:14:25 UTC
We discussed the topic in the design meeting.

Ideas are

+ "Only Unicode 'Basic Latin' characters can be entered" with tooltip "Characters in the Unicode 'Basic Latin' block (also known as ASCII) including the letters A-Z, a-z, numbers 0-9 and the most common punctuation marks."
+ "Character not allowed. Read the help page for a list of allowed characters."
+ "Character not allowed, only basic Latin alphabets, numbers and punctuations can be used."
+ "Character not accepted"

(essentially forwarding to a more explanatory help page)

Code pointer: sfx2/uiconfig/ui/password.ui