More comments, notes and improvements

week1/day5.ipynb

@@ -7,6 +7,10 @@
    "source": [
     "# A full business solution\n",
     "\n",
+    "## Now we will take our project from Day 1 to the next level\n",
+    "\n",
+    "### BUSINESS CHALLENGE:\n",
+    "\n",
     "Create a product that builds a Brochure for a company to be used for prospective clients, investors and potential recruits.\n",
     "\n",
     "We will be provided a company name and their primary website.\n",
@@ -60,6 +64,9 @@
     "# A class to represent a Webpage\n",
     "\n",
     "class Website:\n",
+    "    \"\"\"\n",
+    "    A utility class to represent a Website that we have scraped, now with links\n",
+    "    \"\"\"\n",
     "    url: str\n",
     "    title: str\n",
     "    body: str\n",
@@ -107,6 +114,8 @@
     "It should decide which links are relevant, and replace relative links such as \"/about\" with \"https://company.com/about\".  \n",
     "We will use \"one shot prompting\" in which we provide an example of how it should respond in the prompt.\n",
     "\n",
+    "This is an excellent use case for an LLM, because it requires nuanced understanding. Imagine trying to code this without LLMs by parsing and analyzing the webpage - it would be very hard!\n",
+    "\n",
     "Sidenote: there is a more advanced technique called \"Structured Outputs\" in which we require the model to respond according to a spec. We cover this technique in Week 8 during our autonomous Agentic AI project."
    ]
   },