[libreoffice-l10n] Re: [libreoffice-documentation] Broken assumptions about menu structure in help content

Hello Ilmari, *,

I would be happy to help too, but I'm afraid, I have no much time even
in the next 2 weeks at least.

But it would be great to see one of my pet bugs goes before 6.3 freeze
arrives:

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

What can I do (even with little time for now) for achieving this?

BTW: How is your work with the shell script ongoing?

Am 12.05.2019 um 19:42 schrieb Ilmari Lauhakangas:
> Currently most of the help content referring to menus is incorrect and
> has been for years. One reason for this sad situation is that due to
> ancient structural decisions, it is outrageously difficult to adapt
> the content to changes.
>
> Here is the story in a nutshell:
>
> 1. The help system is architected. Repetition in content related to
> menu items is avoided by clever structuring (hooray! the savings!)
> 2. Content is added, references to menus spread far and wide
> 3. Menu item locations are changed in a massive redesign operation,
> making the help content obsolete
>
> The pain is mostly caused by assumptions that certain menus of certain
> modules are identical. Impress and Draw are the most problematic in
> this regard.
>
> Then we have the "how to access" pages with increasingly mixed
> content. Consider the one for Edit menu, which now contains wonderful
> entries like "Choose Edit - ImageMap in Writer and Calc or Tools -
> ImageMap in Impress and Draw" or entries referring to a completely
> different menu like "Choose Tools - Bibliography Database" and "Choose
> View - Navigator".
> https://helponline.libreoffice.org/6.3/en-US/text/shared/00/edit_menu.html
>
>
> We need a system, where the help content concerning the location of
> menu items is automatically generated from the menu bar definition
> files. If shared information on menus is desired, it needs to be
> produced automatically.
>
> The reason I add l10n list in Cc is that I want to raise awareness of
> the current situation. Having incorrect information translated into
> nearly 200 languages just multiplies the number of negative
> experiences. Translators cannot fix this on the level of strings, it
> needs to be dealt with structurally. It would be great, if members
> from the stronger translation teams (de, fr, id...) would participate
> in the current manual effort on fixing the menu help information.
>
> Here are a few patches from me that show, how the changes can be done:
> https://gerrit.libreoffice.org/#/c/68830/
> https://gerrit.libreoffice.org/#/c/71436/
> https://gerrit.libreoffice.org/#/c/71703/
>
> If people get interested, I can offer assistance.
>
> Ilmari
-- 
Kindly Regards / Mit freundlichen Grüßen

Sophia Schröder
www.libreoffice.org
German Language Team
Help Files Debugger
IRC@freenode: SophiaS



-- 
To unsubscribe e-mail to: l10n+unsubscribe@global.libreoffice.org
Problems? https://www.libreoffice.org/get-help/mailing-lists/how-to-unsubscribe/
Posting guidelines + more: https://wiki.documentfoundation.org/Netiquette
List archive: https://listarchives.libreoffice.org/global/l10n/
Privacy Policy: https://www.documentfoundation.org/privacy