[Libreoffice-ux-advise] [Bug 127294] Add more tips of the day (and make it module-specific eventually)

[bugzilla-daemon at bugs.documentfoundation.org]

https://bugs.documentfoundation.org/show_bug.cgi?id=127294

--- Comment #58 from sdc.blanco at youmail.dk ---
(In reply to Heiko Tietze from comment #56)

> > (2) Are the "single quotes" on  ‘Edit Section’ and  ‘Protect’ all right? 
> > (seemed relevant to highlight them in some way)
> 
> Correct quotation according the book
> https://wiki.documentfoundation.org/Design/Guidelines/UIWriting is with
> U+201C and U+201D

Thanks for the pointer to this useful document (which seems important for all
tip writers/editors to know about).

I can see you are the author of that page, but doesn't Quotation refer to cases
where one is copying another text?

Meanwhile, I can see that more or less all the actual tips in tipoftheday.hrc 
use single quotes, not the double quotes (U+201C and U+201D) that you recommend
here.

Also, according to that document, U+25B8 should be used for menu items.  In
other words, all the current tips have violated that rule by using ">".  (maybe
those should be changed?)

In my original query, I avoided asking about whether there was a convention
(design guideline) for how to refer to items in right-click menus and in dialog
boxes (and was just using single quotes, like other examples in
tipoftheday.hrc).  But when I can see there is a design guideline for the menu
items (U+25B8), then maybe there should be some for referring to right-click
menu items and dialog box items?

> > Want to hide some text in a document?  Select the text.  Insert > Section,
> > and select ‘Hide’.  To make text visible again, use Hide==1 in ‘With
> > Condition’.
> 
> That's a bit simplified. You have to create the variable "Hide" first
> (better with a different name as the label) to use this under the condition.

Hmmm....  I did not create the variable!  (I just tried it, and was surprised
that it worked.)  But now I have looked a little in the Advanced Configuration.
 Maybe it was defined in: 

org.openoffice.Office.UI.Commands:LabelType['.uno:HideCurPage']

Need advice/opinions here.  I believe this method works, but perhaps it is too
risky to rely on something being defined in the Expert Configuration?  In which
case, maybe just drop the entire sentence "To make text visible again...."


> > Questions:  (3) Depending on the answer to question(2), maybe there should
> > be changes with the single quotes?
> 
> Adolfo drives the typography. And since he didn't write anything about
> single/double I presume it has to be double.

See longer discussion at beginning of this comment.  Would be useful/practical
to get a clear decision -- if there are going to be design guidelines.

> > (4) I found this help file, but was uncertain if it could be entered as a
> > uri, instead of a url. 
> > https://help.libreoffice.org/6.4/en-US/text/swriter/guide/hidden_text.
> > html#hd_id3148675
> 
> How to add references to the help is described in the comment of the hrc
> file. It's a bit cumbersome.

I could not figure it out, which is why I was asking here.
> 
> > (5) I guessed about how to refer to specifically to the #section part of the
> > help page, but seems to only work partially.  Leave it?  Drop it?
> 
> The tip should make the user interested, the precise workflow is up to the
> help. So always add a reference, if possible.

Yes.  I was adding the reference, but:  

https://help.libreoffice.org/6.4/en-US/text/swriter/guide/hidden_text.html is a
generic help page about hiding text, not just with sections. 

So I tried to use the # convention with URLs, to go directly to the relevant
section on the page. 

https://help.libreoffice.org/6.4/en-US/text/swriter/guide/hidden_text.html#hd_id3148675

but it is not the best result.  I could not see how to improve it.  By the way,
this "help page" is where I got the idea to try Hide == 1

-- 
You are receiving this mail because:
You are on the CC list for the bug.