No Code Attached Yet
avatar horus68
horus68
11 Jul 2021

Is your feature request related to a problem? Please describe.

Language files includes links to non joomla sites as in "more informations on specific subject".
If/When those links changes there is a need to fix the master language and all translations.

Describe the solution you'd like

1- Any informative non joomla link will be removed from language files.
This will not cover the mandatory GPL license https://www.gnu.org/licenses/gpl-2.0.html
2- Language files would only show a link to a Joomla docs page presenting that specific subject.
3- There the external link for more information will be placed as contents (it could be just with a single external link or getting more text if required later)
4- Any future change will be done in a single place (the Joomla docs) and the language files will have no need to be changed.

Additional context

A list of external links for "More information" i found inside language files:


https://github.com/WICG/floc
https://www.eff.org/deeplinks/2021/03/googles-floc-terrible-idea

https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Referrer-Policy
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/X-Frame-Options
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy/script-src
https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP

https://en.wikipedia.org/wiki/Cross-site_scripting
https://en.wikipedia.org/wiki/Clickjacking
https://en.wikipedia.org/wiki/Google_Authenticator
https://en.wikipedia.org/wiki/Google_Authenticator#Implementation

https://support.google.com/accounts/answer/1066447

This ones could be just links to services, need to be checked

https://freeotp.github.io
https://hstspreload.org
http://skin.tiny.cloud
https://www.google.com/recaptcha
avatar horus68 horus68 - open - 11 Jul 2021
avatar joomla-cms-bot joomla-cms-bot - change - 11 Jul 2021
Labels Added: ?
avatar joomla-cms-bot joomla-cms-bot - labeled - 11 Jul 2021
avatar horus68 horus68 - change - 11 Jul 2021
The description was changed
avatar horus68 horus68 - edited - 11 Jul 2021
avatar brianteeman
brianteeman - comment - 11 Jul 2021

For many of those links the reason they are in the language file is so that the TT can update the links to the correct link for their language.

For example https://developer.mozilla.org/en-US/docs/Web/HTTP/CSP would be translated to https://developer.mozilla.org/fr/docs/Web/HTTP/CSP

avatar zero-24
zero-24 - comment - 11 Jul 2021

Hmm I'm not sure whether it would make sense to maintain our own CSP / HTTP Headers docs or copies of other well trused and up-to-date docs and copy them to docs.joomla.org specificly that they are about very general non-joomla specific topics, i personally would say that the docs.joomla.org should focus on joomla specific docs.
Given that the links are within the language string the TT in question is free to point the link to better informations or translations like brian mentiond too.
And I dont have the fear that with that very limited set of links as presented here we will have major issues with changing URLs.

avatar brianteeman
brianteeman - comment - 11 Jul 2021

All this will really do is to move the task from the translation team to the documentation team for no benefit

avatar horus68
horus68 - comment - 11 Jul 2021

I'm not suggesting to have a copy of those content pages inside Joomla docs.
Joomla docs will be linked from the language file but only need to have the external link, so the language files will never require to be updated just for an external link change.

avatar brianteeman
brianteeman - comment - 24 Feb 2022

Seems pointless to me but someone should make a decision and either apply this change request or close it

cc @bembelimen @roland-d

avatar bembelimen bembelimen - change - 25 Feb 2022
Status New Closed
Closed_Date 0000-00-00 00:00:00 2022-02-25 09:21:38
Closed_By bembelimen
Labels Added: No Code Attached Yet
Removed: ?
avatar bembelimen bembelimen - close - 25 Feb 2022
avatar bembelimen
bembelimen - comment - 25 Feb 2022

I see the point in theory that it could give a very small benefit for translators, but TBH it would lead to a very big overhead and work for other teams and maintainers. So for me it's a clear "NO" to change it.

Add a Comment

Login with GitHub to post a comment