Added some description to mlflow example

Author: oindrillac

MLflow/MLflow_example.ipynb

@@ -11,7 +11,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 1,
+   "execution_count": 3,
    "metadata": {},
    "outputs": [],
    "source": [
@@ -30,14 +30,35 @@
     "## Set up connection "
    ]
   },
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "ML Flow helps track experiments and runs within a particular data science project. As per MLFlow tracking conventions :\n",
+    "\n",
+    "- An **experiment** corresponds to a particular version of code or model. Each experiment will be tracked as different commits within git.\n",
+    "\n",
+    "- A **run** corresponds to a different hyper parameter setting or different feature engineering within same experiment. Runs are tracked within each ML Flow experiment\n",
+    "\n",
+    "1) Set up the ML Flow client and point it to our current MLFlow deployment : http://mlflow-server-route-aiops-prod-prometheus-scrape.cloud.paas.psi.redhat.com/#/\n",
+    "\n",
+    "2) Start a new MLflow run, setting it as the active run under which metrics and parameters will be logged\n",
+    "\n",
+    "3) Set an experiment for tracking a particular project \n",
+    "\n",
+    "4) Each run corresponds to a training cycle. Associate run name to version of code (experiment)\n",
+    "\n",
+    "5) Start a run"
+   ]
+  },
   {
    "cell_type": "markdown",
    "metadata": {},
    "source": [
     "### Connection configurations set by the user:\n",
     "\n",
     "* **MLFLOW_URI**: route to deployment\n",
-    "* **EXPERIMENT_NAME**: Name for entire set of experiments you want to compare. Think of this as the folder this run will live in.  \n",
+    "* **EXPERIMENT_NAME**: Name for entire set of experiments you want to compare. Think of this as the folder this run will live in or a particular version of the code or model.\n",
     "* **RUN_NAME**: custom name for this specific run"
    ]
   },
@@ -560,7 +581,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.6.3"
+   "version": "3.7.4"
   }
  },
  "nbformat": 4,