Added troubleshooting section to the docs page

docs/agents.md

@@ -93,16 +93,6 @@ _(This example is complete, it can be run "as is")_
 
 You can also pass messages from previous runs to continue a conversation or provide context, as described in [Messages and Chat History](message-history.md).
 
-!!! note "jupyter notebooks"
-    If you're running `pydantic-ai` in a jupyter notebook, you might consider using [`nest-asyncio`](https://pypi.org/project/nest-asyncio/)
-    to manage conflicts between event loops that occur between jupyter's event loops and `pydantic-ai`'s.
-
-    Before you execute any agent runs, do the following:
-    ```python {test="skip" lint="skip"}
-    import nest_asyncio
-
-    nest_asyncio.apply()
-    ```
 
 ### Additional Configuration
 

docs/troubleshooting.md

@@ -0,0 +1,16 @@
+# Troubleshooting
+
+Common/known issues are shown below with associated solutions.
+
+## Jupyter Notebooks
+
+If you're running `pydantic-ai` in a jupyter notebook, you might consider using [`nest-asyncio`](https://pypi.org/project/nest-asyncio/)
+to manage conflicts between event loops that occur between jupyter's event loops and `pydantic-ai`'s.
+
+Before you execute any agent runs, do the following:
+
+```python {test="skip" lint="skip"}
+import nest_asyncio
+
+nest_asyncio.apply()
+```

mkdocs.yml

@@ -14,6 +14,7 @@ nav:
   - install.md
   - help.md
   - contributing.md
+  - troubleshooting.md
   - Documentation:
     - agents.md
     - models.md