docs: clarify basic_memory pydocs

Author: simba-git

examples/basic_memory/app.py

@@ -43,14 +43,24 @@ async def create_note(
     tags: list[str] | None = None,
     note_id: str | None = None,
 ) -> Note:
-    """Create or replace a note."""
+    """Create and persist a new note.
+
+    This should be used whenever something useful about a user is learned that
+    you may want to remember in the future. Remember useful details and
+    summarize it to be useful in the future. This call is relevant in all
+    conversations.
+    """
     note = project.create_note(title, content, tags, note_id=note_id)
     return Note.model_validate(note.model_dump())
 
 
 @app.retrieve
 async def get_note(note_id: str) -> Note:
-    """Retrieve a single note by its identifier."""
+    """Retrieve a single note by its identifier.
+
+    This is used to remember detailed information about a user from previously
+    in this or a different conversation.
+    """
     note = project.get_note(note_id)
     if note is None:
         raise ValueError("note not found")
@@ -59,7 +69,11 @@ async def get_note(note_id: str) -> Note:
 
 @app.retrieve
 async def list_notes(page: int = 1, page_size: int = 10) -> list[NoteSummary]:
-    """Return a paginated list of notes."""
+    """Return a paginated list of memory notes that have been made in previous conversations
+    that have details and memories about the user. It's typically a good idea to
+    use this if you think there may have been relevant information or you can
+    personalize based on the conversation or question using past memory.
+    """
     return project.list_notes(page, page_size)