More comments, notes and improvements

week1/troubleshooting.ipynb

@@ -23,7 +23,7 @@
     "\n",
     "Try running the next cell (click in the cell under this one and hit shift+return).\n",
     "\n",
-    "If this doesn't work, then you're not running in an \"activated\" environment. Please check back in the [README](../README.md) for setting up the Anaconda (or virtualenv) environment and activating it, before running `jupyter lab`."
+    "If this doesn't work, then you're likely not running in an \"activated\" environment. Please check back in the [README](../README.md) for setting up the Anaconda (or virtualenv) environment and activating it, before running `jupyter lab`."
    ]
   },
   {
@@ -76,6 +76,11 @@
     "If it didn't print a key, then it's not able to find a file called `.env` in the `llm_engineering` folder.  \n",
     "Double check those steps in the instructions. Is it possible that `.env` is actually called `.env.txt`? In Windows, you may need to change a setting in the File Explorer to ensure that file extensions are showing. Or you will see them if you type `dir` in the `llm_engineering` directory.\n",
     "\n",
+    "Nasty gotchas to watch out for:  \n",
+    "- In the .env file, there should be no space between the equals sign and the key. Like: `OPENAI_API_KEY=sk-proj-...`\n",
+    "- If you copied and pasted your API key from another application, make sure that it didn't replace hyphens in tour key with long dashes\n",
+    "- If you changed your .env file, you might need to restart your Jupyter \"kernel\" (the python process) to pick up the change via the Kernel menu >> Restart kernel, then rerun the cells from the top.\n",
+    "\n",
     "Worst case, if you're not able to get this part to work, it's not a big deal. You'll just have to paste your key into the Jupyter Notebook (see below for an example), and be sure to remove it before you share the Notebook with anybody else."
    ]
   },