Bug 160224 - Rename "built-in help"
Summary: Rename "built-in help"
Status: UNCONFIRMED
Alias: None
Product: LibreOffice
Classification: Unclassified
Component: Localization (show other bugs)
Version:
(earliest affected)
unspecified
Hardware: All All
: medium minor
Assignee: Not Assigned
URL:
Whiteboard:
Keywords:
Depends on:
Blocks: Help
  Show dependency treegraph
 
Reported: 2024-03-15 20:05 UTC by Tuomas Hietala
Modified: 2024-04-14 15:00 UTC (History)
3 users (show)

See Also:
Crash report or crash signature:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Tuomas Hietala 2024-03-15 20:05:54 UTC
Description:
There are a couple of strings in LO UI and some more in LO Help which refer to "built-in help" and its installation. I think this is a contradiction in terms, because if something needs to be installed separately, it is by definition not "built-in".

On the l10n mailing list Andika Triwidada suggested that "local" or "offline" could be a better word for describing the help. I think either would be better than "built-in". Another option would be to always treat it as a proper name (Help).


Steps to Reproduce:
1. UI: https://translations.documentfoundation.org/search/libo_ui-master/-/en/?q=built-in+help&sort_by=-priority%2Cposition&checksum=
2. Help: https://translations.documentfoundation.org/search/libo_help-master/-/en/?q=built-in+help&sort_by=-priority%2Cposition&checksum=


Actual Results:
The strings refer to "installing the built-in help".


Expected Results:
The strings refer to something like "installing the offline help".


Reproducible: Always


User Profile Reset: No

Additional Info:
n/a
Comment 1 V Stuart Foote 2024-03-16 01:01:14 UTC
-1

The "built-in" help can be either locally installed--or is linked to on-line service delivery of the same content when not locally installed.

What makes it built-in is that the linkages are internal to the LibreOffice UI. 

Whether it is installed and local/offline or delivered as web content via an active network link--it is the same "built-in" help.

This is distinct from other project documentation: e.g. Wiki delivery, published guides, etc. [1]

A whimsical change of legacy nomenclature would not improve delivery. 

=-ref-=
[1] https://wiki.documentfoundation.org/Documentation
Comment 2 Adolfo Jayme Barrientos 2024-03-16 07:17:02 UTC
In several languages, “built-in” is translated as “integrated”; maybe you can use the equivalent term in your language to convey the idea.
Comment 3 Tuomas Hietala 2024-03-20 20:42:44 UTC
(In reply to V Stuart Foote from comment #1)
> This is distinct from other project documentation: e.g. Wiki delivery,
> published guides, etc. [1]

No, it's not distinct at all. In the Help menu in LO there are also links to guides, Ask LibreOffice, feedback page, contribution page, and donation page. Should all of these be called "built-in" because there's a link in the UI?

> 
> A whimsical change of legacy nomenclature would not improve delivery. 
> 
> =-ref-=
> [1] https://wiki.documentfoundation.org/Documentation
Comment 4 Tuomas Hietala 2024-03-20 20:48:56 UTC
(In reply to Adolfo Jayme Barrientos from comment #2)
> In several languages, “built-in” is translated as “integrated”; maybe you
> can use the equivalent term in your language to convey the idea.

Sure, but I also try to contribute to the quality of the English strings in the hope that I can spare future users and translators from some confusion.
Comment 5 Tuomas Hietala 2024-03-20 21:15:57 UTC
BTW, in the vast majority of cases Help is treated as a proper name, "%PRODCUTNAME Help". "Built-in help" is the exception, used only in a comparatively small number of strings. So what exactly makes this exception absolutely untouchable is beyond my comprehension...