Improved readability

Author: LukasGold

docs/tutorials/basics.ipynb

@@ -637,18 +637,12 @@
    "source": [
     "# Let's document all storing processes in a list\n",
     "stored = []\n",
-    "# Let's store the entity\n",
+    "\n",
+    "# Storing an entity requires only one line:\n",
     "res = osw_obj.store_entity(john)\n",
-    "stored.append(res)\n",
-    "# In this specific case equivalent to:\n",
-    "params = prm.StoreEntityParam(\n",
-    "    entities=[john],\n",
-    "    namespace=john.get_namespace(),\n",
-    "    parallel=False,\n",
-    "    overwrite=\"keep existing\",\n",
-    "    overwrite_per_class=None,\n",
-    ")  # All default values included\n",
-    "# osw_obj.store_entity(params)"
+    "\n",
+    "# But to be able to access all storage event later on, we will append the result to the list\n",
+    "stored.append(res)"
    ],
    "id": "99cf8828bee651ee"
   },
@@ -657,7 +651,18 @@
    "id": "639db64348bbd905",
    "metadata": {},
    "source": [
-    "Like most methods and functions in the osw-python library, the `store_entity` takes only a single argument. Usually \n",
+    "```python\n",
+    "# In this specific case equivalent to:\n",
+    "params = prm.StoreEntityParam(\n",
+    "    entities=[john],\n",
+    "    namespace=john.get_namespace(),\n",
+    "    parallel=False,\n",
+    "    overwrite=\"keep existing\",\n",
+    "    overwrite_per_class=None,\n",
+    ")  # All default values included\n",
+    "stored.append(osw_obj.store_entity(params))\n",
+    "```\n",
+    "Like most methods and functions in the osw-python library, the `store_entity` takes only a single argument. Usually\n",
     "either a specific object type or a dedicated params object is accepted. If an object of type other than the params \n",
     "object is passed, it is usually tested for compatibility and put inside a params object, filling the other parameters \n",
     "with default values. \n",