feat(uibuilder): document edge case for Application Link

modules/ROOT/pages/release-notes.adoc

@@ -15,6 +15,7 @@ Available in all Scale subscription and as a payable add-on in Convert subscript
 === Application Links
 
 You can now use application links. See xref:applications:bonita-ui-builder.adoc[Applications with Bonita UI Builder] for more details. Community users can also integrate their own links for applications developed with other tools.
+See xref:applications:faq.adoc[FAQ] for common problems and solutions (e.g. if you use a customized or an old layout).
 
 xref:api:engine-api-overview.adoc[Engine APIs] that allowed applications manipulation still work with legacy applications and have been deprecated in favor of new APIs that manipulate both application links and legacy applications.
 

modules/applications/pages/faq.adoc

@@ -1,7 +1,21 @@
 = FAQ
-:description:
+:description:Find here the answers to the frenquently asked questions about Bonita UI Builder and Application Links.
+
+== My application link is incorrect when accessing the Application Directory from my custom application.
+
+image::images/app-link/incorrectAppLink.gif[Application has incorrect Link]
+
+If you have customized e.g. the Bonita User Application, you may be using an old version of the layout.
+
+image::images/app-link/issueOldLayout.png[Application with old layout]
+
+In that case, the Application Directory opened from that application only will not display Application Links correctly, but the same way as Legacy Applications. +
+Fix this by using `custompage_layoutBonita` as the layout value, which will automatically migrate to the latest layout.
+
+You may also encounter this issue if you use a xref:applications:customize-layouts.adoc[customized layout] instead of the official one. In that case, adapt your layout and report your modifications to the latest layout version that implements the improvements for Application Links.
+
 
 [NOTE]
 ====
-For Subscription editions only.
+Bonita UI Builder is for Subscription editions only.
 ====