feat: update Notebook docs (#5089)

* update Notebook docs

* Danil review

* Danil review round 2

Author: AlejandraPedroza

docs/images/kotlin-notebook/create-notebook-welcome.png

@@ -31,8 +31,9 @@ Additionally, export your output charts in a matter of clicks.
 
 ## Notebooks
 
-_Notebooks_ are interactive editors that integrate code, graphics, and text in a single environment. When using a notebook, 
-you can run code cells and immediately see the output. 
+A _notebook_ is an interactive document where you can mix executable Kotlin code with text, visualizations, and results. 
+Think of it as a Kotlin REPL extended with the ability to organize your code into cells, document it with Markdown, 
+and immediately display outputs (from text to plots) alongside the code that produced them.
 
 Kotlin offers different notebook solutions, such as [Kotlin Notebook](#kotlin-notebook), [Datalore](#kotlin-notebooks-in-datalore), 
 and [Kotlin-Jupyter Notebook](#jupyter-notebook-with-kotlin-kernel), providing convenient features for data retrieving, transformation, exploration, modeling, and more.

docs/images/kotlin-notebook/notebook-get-started-button.svg

@@ -18,6 +18,7 @@ see [Set up an environment](kotlin-notebook-set-up-env.md).
 Create a new Kotlin Notebook:
 
 1. Select **File** | **New** | **Kotlin Notebook**.
+
 2. Ensure you have access to an SQL database, such as MariaDB or MySQL.
 
 ## Connect to database

docs/topics/data-analysis-overview.md

@@ -17,6 +17,7 @@ see [Set up an environment](kotlin-notebook-set-up-env.md).
 Create a new Kotlin Notebook:
 
 1. Select **File** | **New** | **Kotlin Notebook**.
+
 2. In your notebook, import the Kandy and Kotlin DataFrame libraries by running the following command:
 
     ```kotlin

docs/topics/data-analysis/data-analysis-connect-to-db.md

@@ -22,12 +22,13 @@ see [Set up an environment](kotlin-notebook-set-up-env.md).
 Create a new Kotlin Notebook:
 
 1. Select **File** | **New** | **Kotlin Notebook**.
+
 2. In the Kotlin Notebook, import the Kotlin DataFrame library by running the following command:
 
    ```kotlin
    %use dataframe
    ```
-
+   
 ## Fetch data from an API
 
 Fetching data from APIs using the Kotlin Notebook with the Kotlin DataFrame library is achieved through the [`.read()`](https://kotlin.github.io/dataframe/read.html) 

docs/topics/data-analysis/data-analysis-visualization.md

@@ -22,6 +22,7 @@ see [Set up an environment](kotlin-notebook-set-up-env.md).
 Create a new Kotlin Notebook:
 
 1. Select **File** | **New** | **Kotlin Notebook**.
+
 2. In the Kotlin Notebook, import the Kotlin DataFrame library by running the following command:
 
    ```kotlin

docs/topics/data-analysis/data-analysis-work-with-api.md

@@ -34,6 +34,13 @@ You can also use the autocompletion feature in Kotlin Notebook to quickly access
 
 ![Autocompletion feature in Kotlin Notebook](autocompletion-feature-notebook.png){width=700}
 
+> Kotlin Notebook has a set of integrated libraries to perform various tasks, from deep learning to HTTP networking.
+> See [Import supported libraries](https://www.jetbrains.com/help/idea/kotlin-notebook.html#import-libraries).
+> 
+> You can also add and use libraries that are not yet integrated into Kotlin Notebook. See [Integrate new libraries](https://www.jetbrains.com/help/idea/kotlin-notebook.html#integrate-new-libraries).
+>
+{style="note"}
+
 ## Add Kotlin DataFrame and Kandy libraries to your Kotlin Notebook
 
 Let's add two popular Kotlin library dependencies to your Kotlin Notebook: