RHIDP-8635-1 - Comprehensive documentation for developers on adding localization support to custom plugins

Author: Gerry-Forde

modules/configuring-a-floating-action-button/con-localization-support-for-the-floating-action-button.adoc

@@ -3,7 +3,7 @@
 
 You can enable translation key support for floating action buttons, so that users can onboard in their preferred language. In {product-short}, all existing and newly created floating action buttons support localization using dedicated translation keys. 
 
-The *Global Floating Action* button plugin supports internationalization (i18n) through translation keys. You can use `labelKey` and `toolTipKey` properties to provide translation keys instead of static text.
+The Global Floating Action Button plugin supports internationalization (i18n) through translation keys. You can use `labelKey` and `toolTipKey` properties to provide translation keys instead of static text.
 
 The plugin provides the following built-in translation keys organized under the `fab` namespace:
 
@@ -27,6 +27,14 @@ The plugin includes translations for the following supported languages:
 * French (fr)
 // * Spanish (es)
 
+// [NOTE]
+// ====
+// To add localization support for a new floating action button item, you can add any arbitrary key name for the `labelKey` and `toolTipKey` properties and provide corresponding translations for those keys.
+
+// If you add a new floating action button item, you can add localization support by adding an arbitary label key and tool tip key 
+
+// ====
+
 To ensure backward compatibility while providing translation support when available, the following order is used to resolve string translations:
 
 . If the `labelKey` is provided, the plugin will attempt to resolve the translation key

modules/configuring-a-floating-action-button/proc-configuring-floating-action-button-as-a-dynamic-plugin.adoc

@@ -205,7 +205,7 @@ To configure a floating action button as a dynamic plugin, complete any of the f
 `frontend:mountPoints:importName`:: Enter the import name with an associated component to the mount point.
 
 = Translation support
-The *Global Floating Action* button plugin supports internationalization (i18n) through translation keys. You can use `labelKey` and `toolTipKey` properties to provide translation keys instead of static text.
+The Global Floating Action Button plugin supports internationalization (i18n) through translation keys. You can use `labelKey` and `toolTipKey` properties to provide translation keys instead of static text.
 
 Example for using translation keys in dynamic configuration:
 [source,yaml]
@@ -216,6 +216,9 @@ Example for using translation keys in dynamic configuration:
     dynamicPlugins:
       frontend:
         red-hat-developer-hub.backstage-plugin-global-floating-action-button:
+          translationResources:
+            - importName: globalFloatingActionButtonTranslations
+              ref: globalFloatingActionButtonTranslationRef
           mountPoints:
             - mountPoint: application/listener
               importName: DynamicGlobalFloatingActionButton