update more docs and start migration guide

Author: dtam

docs/examples/guardrails_with_chat_models.ipynb

@@ -21,10 +21,7 @@
       "✅Successfully installed guardrails/one_line!\n",
       "\n",
       "\n",
-      "Requirement already satisfied: pypdfium2 in /Users/dtam/.pyenv/versions/3.12.1/lib/python3.12/site-packages (4.30.0)\n",
-      "\n",
-      "\u001b[1m[\u001b[0m\u001b[34;49mnotice\u001b[0m\u001b[1;39;49m]\u001b[0m\u001b[39;49m A new release of pip is available: \u001b[0m\u001b[31;49m23.2.1\u001b[0m\u001b[39;49m -> \u001b[0m\u001b[32;49m24.1.2\u001b[0m\n",
-      "\u001b[1m[\u001b[0m\u001b[34;49mnotice\u001b[0m\u001b[1;39;49m]\u001b[0m\u001b[39;49m To update, run: \u001b[0m\u001b[32;49mpip install --upgrade pip\u001b[0m\n",
+      "Requirement already satisfied: pypdfium2 in /Users/dtam/.pyenv/versions/3.12.3/envs/litellm/lib/python3.12/site-packages (4.30.0)\n",
       "Note: you may need to restart the kernel to use updated packages.\n"
      ]
     }
@@ -62,49 +59,9 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 1,
+   "execution_count": null,
    "metadata": {},
-   "outputs": [
-    {
-     "name": "stderr",
-     "output_type": "stream",
-     "text": [
-      "/Users/dtam/.pyenv/versions/3.12.3/envs/litellm/lib/python3.12/site-packages/pypdfium2/_helpers/textpage.py:80: UserWarning: get_text_range() call with default params will be implicitly redirected to get_text_bounded()\n",
-      "  warnings.warn(\"get_text_range() call with default params will be implicitly redirected to get_text_bounded()\")\n"
-     ]
-    },
-    {
-     "data": {
-      "text/html": [
-       "<pre style=\"white-space:pre;overflow-x:auto;line-height:normal;font-family:Menlo,'DejaVu Sans Mono',consolas,'Courier New',monospace\">Chase Credit Card Document:\n",
-       "\n",
-       "<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">2</span>/<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">25</span>/<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">23</span>, <span style=\"color: #00ff00; text-decoration-color: #00ff00; font-weight: bold\">7:59</span> PM about:blank\n",
-       "about:blank <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">1</span>/<span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">4</span>\n",
-       "PRICING INFORMATION\n",
-       "INTEREST RATES AND INTEREST CHARGES\n",
-       "Purchase Annual\n",
-       "Percentage Rate <span style=\"font-weight: bold\">(</span>APR<span style=\"font-weight: bold\">)</span> <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">0</span>% Intro APR for the first <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">18</span> months that your Account is open.\n",
-       "After that, <span style=\"color: #008080; text-decoration-color: #008080; font-weight: bold\">19.49</span>%. This APR will vary with the market based on the Prim\n",
-       "<span style=\"color: #808000; text-decoration-color: #808000\">...</span>\n",
-       "</pre>\n"
-      ],
-      "text/plain": [
-       "Chase Credit Card Document:\n",
-       "\n",
-       "\u001b[1;36m2\u001b[0m/\u001b[1;36m25\u001b[0m/\u001b[1;36m23\u001b[0m, \u001b[1;92m7:59\u001b[0m PM about:blank\n",
-       "about:blank \u001b[1;36m1\u001b[0m/\u001b[1;36m4\u001b[0m\n",
-       "PRICING INFORMATION\n",
-       "INTEREST RATES AND INTEREST CHARGES\n",
-       "Purchase Annual\n",
-       "Percentage Rate \u001b[1m(\u001b[0mAPR\u001b[1m)\u001b[0m \u001b[1;36m0\u001b[0m% Intro APR for the first \u001b[1;36m18\u001b[0m months that your Account is open.\n",
-       "After that, \u001b[1;36m19.49\u001b[0m%. This APR will vary with the market based on the Prim\n",
-       "\u001b[33m...\u001b[0m\n"
-      ]
-     },
-     "metadata": {},
-     "output_type": "display_data"
-    }
-   ],
+   "outputs": [],
    "source": [
     "import guardrails as gd\n",
     "from rich import print\n",
@@ -149,6 +106,7 @@
     "    ```\n",
     "\n",
     "=== \"Pydantic with messages\"\n",
+    "\n",
     "    ```py\n",
     "    instructions = \"\"\"You are a helpful assistant only capable of communicating with valid JSON, and no other text.\n",
     "\n",
@@ -163,7 +121,7 @@
     "    ${gr.xml_prefix_prompt}\n",
     "\n",
     "    ${output_schema}\"\"\"\n",
-    "    ```\n",
+    "    \n",
     "    messages=[\n",
     "        {\n",
     "            \"role\":\"system\",\n",
@@ -174,6 +132,7 @@
     "            \"content\":prompt\n",
     "        }\n",
     "    ]\n",
+    "    ```\n",
     "\n",
     "=== \"RAIL Spec without user message\"\n",
     "    \n",
@@ -194,6 +153,7 @@
     "    ```\n",
     "\n",
     "=== \"Pydantic without instructions\"\n",
+    "\n",
     "    ```py\n",
     "    prompt = \"\"\"Given the following document, answer the following questions. If the answer doesn't exist in the document, enter `null`.\n",
     "\n",
@@ -325,7 +285,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 3,
+   "execution_count": null,
    "metadata": {},
    "outputs": [],
    "source": [