Explain branches in detail for GitHub workflow for Crowdin (#6195)

Author: brotkrueml

Documentation/ApiOverview/Localization/TranslationServer/Crowdin/ExtensionIntegration.rst

@@ -221,6 +221,13 @@ Step-by-step instructions for GitHub
                         ``<source>`` and ``<target>`` elements. If the ``<source>`` elements are missing,
                         Crowdin will not be able to match the translations with the original English labels.
 
+    ..  important::
+        Using the recommended GitHub workflow the GitHub default branch can be
+        mapped to the Crowdin branch name via the attribute :yaml:`crowdin_branch_name`.
+        It is recommended that you always use `main` as the Crowdin branch name.
+        **More than one Crowdin branch (for example via different
+        GitHub branches) is not supported by the Crowdin Bridge!**
+
 3.  Approve imported translations
 
     After importing existing translations, they will arrive in Crowdin in an

Documentation/ApiOverview/Localization/TranslationServer/Crowdin/Faq.rst

@@ -177,17 +177,29 @@ checkbox.
 Why is translated content not available in TYPO3?
 -------------------------------------------------
 
-*   The translated strings are not approved. As an owner of the Crowdin project
-    (for example, if you're the extension owner) or as proofreader you can approve
-    strings by yourself. Otherwise please ask in the Slack channel
-    `#typo3-localization-team <https://typo3.slack.com/app_redirect?channel=CR75200FL>`__
-    for approval. With the next run of the Crowdin Bridge the translations
-    should be available (approx. every two hours).
-
-*   Only translations provided from the following default branches in your
-    repository are used: `main`, `master`, `release`, `develop`, `dev`,
-    `development`. If you use other branches, the translations are not
-    available — even if they are translated in Crowdin.
+Approval is missing
+~~~~~~~~~~~~~~~~~~~
+
+The translated strings are not approved. As an owner of the Crowdin project
+(for example, if you're the extension owner) or as proofreader you can approve
+strings by yourself. Otherwise please ask in the Slack channel
+`#typo3-localization-team <https://typo3.slack.com/app_redirect?channel=CR75200FL>`__
+for approval. With the next run of the Crowdin Bridge the translations
+should be available (approx. every two hours).
+
+Integration branch is not recognized
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+If the legacy Crowdin <> GitHub integration is used, only translations
+provided from the following default branches in your repository are used:
+`main`, `master`, `release`, `develop`, `dev`, `development`. If you use
+other branches, the translations are not available — even if they are
+translated in Crowdin.
+
+It is recommended to configure the
+:ref:`GitHub workflow as integration for Crowdin <crowdin-extension-integration-github>`,
+this way you define the `crowdin_branch_name` which can be set to
+`main` — independently of your GitHub default branch.
 
 ..  index:: Crowdin; Reconnect your project
 ..  _reconnect-your-project: