diff --git a/docs/source/notebooks/boario-quickstart.ipynb b/docs/source/notebooks/boario-quickstart.ipynb
index ef0baeb..5f98aa2 100644
--- a/docs/source/notebooks/boario-quickstart.ipynb
+++ b/docs/source/notebooks/boario-quickstart.ipynb
@@ -25,7 +25,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 23,
+   "execution_count": 1,
    "id": "dc3e74db-72e0-4dde-bac2-4e6be2d61885",
    "metadata": {},
    "outputs": [],
@@ -46,7 +46,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 24,
+   "execution_count": null,
    "id": "d05964f3-46c6-4a18-ace2-1245b387dfdf",
    "metadata": {},
    "outputs": [],
@@ -67,7 +67,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 25,
+   "execution_count": 3,
    "id": "e8cb2f4a-90db-45c2-a843-2584b933c67a",
    "metadata": {},
    "outputs": [],
@@ -86,7 +86,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 26,
+   "execution_count": 4,
    "id": "dbbaf28c-1395-40b9-8827-b4a67719d530",
    "metadata": {},
    "outputs": [],
@@ -112,7 +112,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 27,
+   "execution_count": 5,
    "id": "05fd6465-4f25-41a2-9ef6-b87089b4ea2e",
    "metadata": {},
    "outputs": [],
@@ -132,7 +132,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 28,
+   "execution_count": 6,
    "id": "e1039d30-5394-49fb-8755-fb830192f947",
    "metadata": {},
    "outputs": [],
@@ -158,11 +158,11 @@
    "source": [
     "Here we define an event happening in region ``reg1`` impacting the productive capital of the ``manufactoring``[^note-1] and ``mining`` sectors. The impact is distributed among the two sectors proportional to their participation to ``reg1``'s GDP. \n",
     "\n",
-    "The entire impact is translated into a reconstruction demand, handled by the ``construction`` (55%) and ``manufactoring`` (45%) sectors. This reconstruction has a characteristic time of 90 unit steps.\n",
+    "Here the entire impact is translated into a reconstruction demand, handled by the ``construction`` (55%) and ``manufactoring`` (45%) sectors. This reconstruction has a characteristic time of 90 unit steps.\n",
     "\n",
-    "See [Defining events](../tutorials/boario-events.rst), for more in depth explanation on how to define events.\n",
+    "There are different types of Event subclasses implented in BoARIO, each with there specificities, to allow the modeling of different types of shocks. See [Defining events](../tutorials/boario-events.rst), for more in depth explanation on how to define events.\n",
     "\n",
-    "[^note-1]: There is a typo in the sector's name in pymrio, not in our code."
+    "[^note-1]: This typo in the \"manufacturing\" sector's name comes from pymrio."
    ]
   },
   {
@@ -175,7 +175,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 29,
+   "execution_count": 7,
    "id": "ba833cbb-5ed0-46c9-bdc5-6cfc38eb919d",
    "metadata": {},
    "outputs": [],
@@ -194,7 +194,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 30,
+   "execution_count": 8,
    "id": "e99a88ca-9c0e-4d73-b513-3e0af572a35d",
    "metadata": {},
    "outputs": [
@@ -224,7 +224,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 32,
+   "execution_count": 9,
    "id": "2c2add52-72fb-45d7-9f7b-ade044acc0f9",
    "metadata": {},
    "outputs": [
@@ -234,7 +234,7 @@
        "<Axes: xlabel='step'>"
       ]
      },
-     "execution_count": 32,
+     "execution_count": 9,
      "metadata": {},
      "output_type": "execute_result"
     },
@@ -258,14 +258,6 @@
     "\n",
     "df.loc[:, (\"reg1\", slice(None))].plot()"
    ]
-  },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "4c58e3e9-b433-4d41-8c96-d0928b231fb2",
-   "metadata": {},
-   "outputs": [],
-   "source": []
   }
  ],
  "metadata": {