Improves various details.

README.md

@@ -198,10 +198,10 @@ A `TinyPerson` is a simulated person with specific personality traits, interests
 
 Each such agent contains a lot of unique details, which is the source of its realistic behavior. This, however, means that it takes significant effort to specify an agent manually. Hence, for convenience, `TinyTroupe` provide some easier ways to get started or generate new agents.
 
-To begin with, `tinytroupe.examples` contains some pre-defined agents that you can use. For example, `tinytroupe.examples.lisa` contains a `TinyPerson` that represents a data scientist. You can use it as follows:
+To begin with, `tinytroupe.examples` contains some pre-defined agent builders that you can use. For example, `tinytroupe.examples.create_lisa_the_data_scientist` creates a `TinyPerson` that represents a data scientist called Lisa. You can use it as follows:
 
 ```python
-from tinytroupe.examples import lisa
+from tinytroupe.examples import create_lisa_the_data_scientist
 
 lisa = create_lisa_the_data_scientist() # instantiate a Lisa from the example builder
 lisa.listen_and_act("Tell me about your life.")
@@ -237,8 +237,8 @@ lisa.define_several("personality_traits",
 ```python
 from tinytroupe.factory import TinyPersonFactory
 
-factory = TinyPersonFactory("Create a Brazilian person that is a doctor, like pets and the nature and love heavy metal.")
-person = factory.generate_person()
+factory = TinyPersonFactory("A hospital in São Paulo.")
+person = factory.generate_person("Create a Brazilian person that is a doctor, like pets and the nature and love heavy metal.")
 ```
 
 ### TinyWorld

data/extractions/appartment_rent_ad.extraction.json

@@ -2,7 +2,7 @@
     "agent_extractions": {},
     "world_extraction": {
         "Focus group": {
-            "ad_copy": "Spacious, Modern Living in a Quiet, Convenient Location! Discover this beautifully renovated apartment with an open design, perfect for students and young professionals. Enjoy the convenience of nearby amenities like supermarkets, gyms, and public transport, while relishing the tranquility of a quiet setting. Ideal for remote work with a home office space, and fully furnished with modern appliances. Don't miss out on this opportunity\u2014contact us today for a virtual tour and special incentives for early renters!"
+            "ad_copy": "Modern, Spacious, and Quiet Living Near Top Medicine School. Highlighting the modern renovation, spacious design, and proximity to amenities and the Medicine School, this furnished apartment offers convenience for tenants looking to move in quickly. Enjoy the quietness despite its central location, making it ideal for students or professionals. High-quality photos and a virtual tour available to showcase its best features."
         }
     }
 }

tests/scenarios/test_jupyter_examples.py

@@ -30,7 +30,7 @@ def test_notebook_execution(notebook_path):
     """Execute a Jupyter notebook and assert that no exceptions occur."""
     with open(notebook_path, "r", encoding="utf-8") as nb_file:
         notebook = nbformat.read(nb_file, as_version=4)
-        print(f"Executing notebook: {notebook_path} with kernl: {KERNEL_NAME}")
+        print(f"Executing notebook: {notebook_path} with kernel: {KERNEL_NAME}")
         ep = ExecutePreprocessor(timeout=TIMEOUT, kernel_name=KERNEL_NAME)
 
         try: