docs(uib): add warning on usage of the PostgresSQL datasource to conn…

…ect on Bonita database

modules/applications/pages/ui-builder/faq.adoc

@@ -7,11 +7,11 @@
 == Bonita UI Builder
 
 === What is Bonita UI Builder? 
-Bonita UI Builder (sometimes abbreviated UIB) is a development environment used for creating all kind on interfaces, whether they are pages or forms or else, that make up an Application. It is a web-based tool that is launched from a Bonitasoft custom docker image. It is the new and only standard used in the Bonita ecosystem for designing interfaces.
+Bonita UI Builder (sometimes abbreviated UIB) is a development environment used for creating all kinds of interfaces, whether they are pages or forms or else, that make up an Application. It is a web-based tool that is launched from a Bonitasoft custom docker image. It is the new and only standard used in the Bonita ecosystem for designing interfaces.
 
 
 === What does it mean for my workflows? 
-There should be no changed in your logic, continuous integration, and workflows. You can still manage them the way you’re managing them today. Just download the docker image and follow the xref:initiation-manual.adoc[initiation manual].
+There should be no change in your logic, continuous integration, and workflows. You can still manage them the way you’re managing them today. Just download the docker image and follow the xref:initiation-manual.adoc[initiation manual].
 
 
 === How to subscribe? 
@@ -25,15 +25,15 @@ Please refer to the xref:initiation-manual.adoc[initiation manual]. If you have
 
 
 === Can I expect any support from Bonitasoft?
-Yes you can!
+Yes, you can!
 
 * Support and resources: We offer extensive documentation, tutorials, and support to help you make the most of xref:bonita-ui-builder.adoc[Bonita UI Builder].
 * Facilitated transition: We are dedicated to facilitate the transition, with detailed guides on how to use Bonita UI Builder, as well as https://www.bonitasoft.com/professional-services/on-demand-services[professional services support].
 
 
 
 === I am using the Open source edition of Bonita, can I use Bonita UI Builder? 
-Unfortunately no. You’ll need to either use Bonita UI Designer or design your interfaces with the language or tool of your choice and integrate them to Bonita. Upgrade to an Access or Scale edition if you want to use Bonita UI Builder.
+Unfortunately, no. You’ll need to either use Bonita UI Designer or design your interfaces with the language or tool of your choice and integrate them to Bonita. Upgrade to an Access or Scale edition if you want to use Bonita UI Builder.
 
 
 
@@ -42,13 +42,15 @@ Bonita UI Builder is compatible with all Bonita versions starting from 2024.3.
 
 
 
-=== What is an `applicationLink` ?
+=== What is an `applicationLink`?
 It is a tag used to describe an Application made with Bonita UI Builder in the Studio’s Application descriptor.
 
 
 
 === Can I use other datasources than Bonita’s? 
-Yes you can. You can call external REST APIs and GraphQL APIs.
+Yes you can. You can call external REST APIs, GraphQL APIs and PostgreSQL database.
+
+WARNING: Avoid using the DB datasource to connect to a Bonita database. Use the Bonita API datasource instead.
 
 
 === How do Bonita UI Builder and Bonita UI Designer compare?
@@ -122,7 +124,7 @@ Yes you can. You can call external REST APIs and GraphQL APIs.
 
 
 === What does it mean for my existing forms and pages? 
-You existing forms and pages will always be compatible with Bonita. Eventually, Bonita UI Designer will be phased out as we fully transition to Bonita UI Builder. We cannot guarantee you will be able to edit your existing interfaces made with Bonita UI Designer in the future versions of Bonita.
+Your existing forms and pages will always be compatible with Bonita. Eventually, Bonita UI Designer will be phased out as we fully transition to Bonita UI Builder. We cannot guarantee you will be able to edit your existing interfaces made with Bonita UI Designer in the future versions of Bonita.
 
 Our goal is to make this transition as smooth as possible, minimizing any disruption to your workflow:
 
@@ -131,12 +133,12 @@ Our goal is to make this transition as smooth as possible, minimizing any disrup
 * Facilitated transition: We are dedicated to facilitate the transition, with detailed guides on how to use Bonita UI Builder, as well as https://www.bonitasoft.com/professional-services/on-demand-services[professional services support]
 
 
-=== Are the interfaces made with Bonita UI Builder compatible with platform mode and self-contained applications ? 
+=== Are the interfaces made with Bonita UI Builder compatible with platform mode and self-contained applications?
 Yes, they are compatible with both deployment modes.
 
 
 === Is Bonita UI Builder Bonita Cloud compatible? 
-Yes it is. Reach out to your customer service representative to explore how you can migrate to Bonita Cloud.
+Yes, it is. Reach out to your customer service representative to explore how you can migrate to Bonita Cloud.
 
 
 === Is it possible to deploy multiple UI Builder node instances for redundancy?

modules/applications/pages/ui-builder/interact-with-your-bonita-process.adoc

@@ -17,7 +17,7 @@ You can interact with the Bonita runtime using the xref:api:rest-api-overview.ad
 == Create Bonita API requests
 
 You can create API requests and interact with the Bonita runtime with the xref:api:rest-api-overview.adoc[REST APIs].
-We will describe below how you can for example get a list of Bonita processes, and instantiate one of them.
+We will describe below how you can, for example, get a list of Bonita processes, and instantiate one of them.
 
 === Get a list of processes
 To get the list of the processeses deployed on the Bonita runtime (first 10): click the `Editor` icon from the left panel, click the `Queries` tab, then click the `new query / API` button and select the Bonita datasource created previously.