update doc

notebooks/mobility/waze.ipynb

@@ -101,12 +101,25 @@
     "In this project, we are using `Traffic Jams dataset`"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "5f6bc536-3167-49b9-a1bf-9b44b1940294",
+   "metadata": {},
+   "source": [
+    "### Jams Dataset\n",
+    "The jams section includes data gathered in real time about traffic slowdowns on specific road segments. The URL includes an array of jams and the start time and date of the report. Waze generates traffic jam information by processing the following data-sources:\n",
+    "\n",
+    "* GPS location-points sent from users phones (users who drive while using the app) and calculations of the actual speed vs. average speed (on specific time-slot) and free-flowspeed (maximum speed measured on the road-segment)\n",
+    "\n",
+    "* User-generated reports shared by Waze users who encounter traffic-jams. These appear as regular alerts, and also affect the way we identify and present trafficjams."
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "49de1d9d-34d4-4fbe-bf89-2dd2230c9ba4",
    "metadata": {},
    "source": [
-    "## Limitations\n",
+    "### Limitations\n",
     "- We do not know how much the number of users vary across the days\n",
     "- We do not know how users are spatialy distributed"
    ]