diff --git a/multi-area-model.ipynb b/multi-area-model.ipynb
index af6ffc99a2b4ea2faf7aa705980d304e2e19a368..cd903083d215a313b5478fdbf612eec91b38087c 100644
--- a/multi-area-model.ipynb
+++ b/multi-area-model.ipynb
@@ -145,7 +145,28 @@
    "id": "d53f1eab",
    "metadata": {},
    "source": [
-    "### 2. Model and simulation parameters"
+    "### 2. Model, simulation and theory parameters"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "e779c727",
+   "metadata": {},
+   "source": [
+    "The parameters fall into 3 categories: Model parameters, Simulation parameters, Theory parameters.<br>\n",
+    "\n",
+    "**Model parameters**<br>\n",
+    "Model paramters are the most important among all the paramters, it directly affect the model itself and thus have a great impact on the simulation results. Model paramters define the connection, input, neuron, and network charateristics of the model.\n",
+    "* Connection paramters\n",
+    "* Input parameters\n",
+    "* Neuron parameters\n",
+    "* Network parameters<br>\n",
+    "\n",
+    "**Simualation parameters**<br>\n",
+    "Simulation parameters define the paramters that influence the process of simulation, inlcuding the simulation time, the number of processes and theads used to run the simulation.<br>\n",
+    "\n",
+    "**Theory parameters**<br>\n",
+    "Theory parameters defines ..."
    ]
   },
   {
@@ -153,7 +174,15 @@
    "id": "14bac1ce-4ba0-47ec-84b2-9d3c72bc96ec",
    "metadata": {},
    "source": [
-    "#### 2.1 Connection parameters (conn_params)"
+    "#### 2.1 Model parameters"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "id": "106a6a5e",
+   "metadata": {},
+   "source": [
+    "* Connection parameters (conn_params)"
    ]
   },
   {
@@ -172,28 +201,12 @@
     "|           |                       | av_indegree_V1              | 3950.              |                   |"
    ]
   },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "7af3a191",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "conn_params = {'replace_non_simulated_areas': 'het_poisson_stat',\n",
-    "               'g': -11.,\n",
-    "               'K_stable': 'K_stable.npy',\n",
-    "               'fac_nu_ext_TH': 1.2,\n",
-    "               'fac_nu_ext_5E': 1.125,\n",
-    "               'fac_nu_ext_6E': 1.41666667,\n",
-    "               'av_indegree_V1': 3950.}"
-   ]
-  },
   {
    "cell_type": "markdown",
    "id": "1688ef55-2fdb-4800-97af-7ea62442c684",
    "metadata": {},
    "source": [
-    "#### 2.2 Input parameters (input_params)"
+    "* Input parameters (input_params)"
    ]
   },
   {
@@ -206,22 +219,12 @@
     "|           |                       | rate_ext                      |      10.             |                   |"
    ]
   },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "2195cddb-bd82-47a8-ba74-cf0169a6801d",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "input_params = {'rate_ext': 10.}"
-   ]
-  },
   {
    "cell_type": "markdown",
    "id": "aefa84c8-baaa-4afa-96c6-5d57d174b286",
    "metadata": {},
    "source": [
-    "#### 2.3 Neuron parameters (neuron_params)"
+    "* Neuron parameters (neuron_params)"
    ]
   },
   {
@@ -235,28 +238,17 @@
     "|           |                       | V0_sd                       | 50.                |                   |"
    ]
   },
-  {
-   "cell_type": "code",
-   "execution_count": null,
-   "id": "f69ad836-70b8-4ebe-b46a-25f48dc3ca7c",
-   "metadata": {},
-   "outputs": [],
-   "source": [
-    "neuron_params = {'V0_mean': -150.,\n",
-    "                 'V0_sd': 50.}"
-   ]
-  },
   {
    "cell_type": "markdown",
-   "id": "cdb50fb3-4bb9-446a-ab1c-d008b7e5bfa4",
+   "id": "ea4e01aa",
    "metadata": {},
    "source": [
-    "#### 2.4 Network parameters (network_params)"
+    "* Network parameters (network_params)"
    ]
   },
   {
    "cell_type": "markdown",
-   "id": "3e437aca-1fd0-4296-a0f6-a346b1319903",
+   "id": "dc4ce111",
    "metadata": {},
    "source": [
     "| Parameter                               | Parameter description | Variable              | Value                         | Value description |\n",
@@ -269,6 +261,43 @@
     "| Neuron parameters                       |                       | neuron_params         | neuron_params                 |                   |"
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "6e4bed8d",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "conn_params = {'replace_non_simulated_areas': 'het_poisson_stat',\n",
+    "               'g': -11.,\n",
+    "               'K_stable': 'K_stable.npy',\n",
+    "               'fac_nu_ext_TH': 1.2,\n",
+    "               'fac_nu_ext_5E': 1.125,\n",
+    "               'fac_nu_ext_6E': 1.41666667,\n",
+    "               'av_indegree_V1': 3950.}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "7e4ede2c",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "input_params = {'rate_ext': 10.}"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "f69ad836-70b8-4ebe-b46a-25f48dc3ca7c",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "neuron_params = {'V0_mean': -150.,\n",
+    "                 'V0_sd': 50.}"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
@@ -289,7 +318,7 @@
    "id": "a0730f70-ed9b-4664-b677-3dda965a01ef",
    "metadata": {},
    "source": [
-    "### 2.5 Simulation paramters (sim_params)"
+    "### 2.2 Simulation paramters (sim_params)"
    ]
   },
   {
@@ -317,7 +346,7 @@
     "              'num_processes': 1,\n",
     "              'local_num_threads': 1,\n",
     "              'recording_dict': {'record_vm': False},\n",
-    "              'rng_seed': 1} # global random seed\n"
+    "              'rng_seed': 1} # global random seed"
    ]
   },
   {
@@ -325,7 +354,7 @@
    "id": "79596d77-c105-45d0-9a57-2d15e31f1189",
    "metadata": {},
    "source": [
-    "### 2.6. Theory paramters (theory_params)"
+    "### 2.3. Theory paramters (theory_params)"
    ]
   },
   {