Docs on ibm_db incompatibility - use ibm_db_dbi

Author: amochin

README.md

@@ -200,7 +200,7 @@ Connect To Database
 </details>
 
 <details>
-<summary>IBM DB2 (ibm_db)</summary>
+<summary>IBM DB2 (ibm_db_dbi)</summary>
 
 ```RobotFramework
 Connect To Database
@@ -447,8 +447,8 @@ Therefore there are some modules, which are "natively" supported in the library
 ### Teradata
 - [teradata](https://github.com/teradata/PyTd)
 ### IBM DB2
-- [ibm_db](https://github.com/ibmdb/python-ibmdb)
-- [ibm_db_dbi](https://github.com/ibmdb/python-ibmdb)
+- The Python package to be installed is [ibm_db](https://github.com/ibmdb/python-ibmdb). It includes two modules - `ibm_db` and `ibm_db_dbi`.   
+- *Using `ibm_db_dbi` is highly recommended* as only this module is Python DB API 2.0 compatible. See [official docs](https://www.ibm.com/docs/en/db2/12.1?topic=applications-python-sqlalchemy-django-framework).
 ### ODBC
 - [pyodbc](https://github.com/mkleehammer/pyodbc)
 - [pypyodbc](https://github.com/pypyodbc/pypyodbc)

doc/index.html

@@ -386,7 +386,7 @@ class DatabaseLibrary(ConnectionManager, Query, Assertion):
     === Oracle ===
     [https://oracle.github.io/python-oracledb/|oracledb]
     - Both thick and thin client modes are supported - you can select one using the `oracle_driver_mode` parameter.
-    - However, due to current limitations of the oracledb module, **it's not possible to switch between thick and thin modes during a test execution session** - even in different suites.
+    - However, due to current limitations of the oracledb module, *it's not possible to switch between thick and thin modes during a test execution session* - even in different suites.
 
     [https://oracle.github.io/python-cx_Oracle/|cx_Oracle]
 
@@ -402,8 +402,8 @@ class DatabaseLibrary(ConnectionManager, Query, Assertion):
     === Teradata ===
     - [https://github.com/teradata/PyTd|teradata]
     === IBM DB2 ===
-    - [https://github.com/ibmdb/python-ibmdb|ibm_db]
-    - [https://github.com/ibmdb/python-ibmdb|ibm_db_dbi]
+    - The Python package to be installed is [https://github.com/ibmdb/python-ibmdb|ibm_db]. It includes two modules - `ibm_db` and `ibm_db_dbi`.
+    - Using *`ibm_db_dbi` is highly recommended* as only this module is Python DB API 2.0 compatible. See [https://www.ibm.com/docs/en/db2/12.1?topic=applications-python-sqlalchemy-django-framework|official docs].
     === ODBC ===
     - [https://github.com/mkleehammer/pyodbc|pyodbc]
     - [https://github.com/pypyodbc/pypyodbc|pypyodbc]

src/DatabaseLibrary/__init__.py

@@ -209,7 +209,7 @@ def connect_to_database(
 
         Other custom params from keyword arguments and config file are passed to the Python DB module as provided -
         normally as arguments for the _connect()_ function.
-        However, when using *pyodbc* or *ibm_db*, the connection is established using a *connection string* -
+        However, when using *pyodbc* or *ibm_db_dbi*, the connection is established using a *connection string* -
         so all the custom params are added into it instead of function arguments.
 
         Set ``alias`` for `Handling multiple database connections`.