Improve docs

Author: dmerejkowsky

cli_ui/__init__.py

@@ -546,10 +546,13 @@ def select_choices(
     func_desc: Optional[FuncDesc] = None,
     sort: Optional[bool] = True,
 ) -> Any:
-    """Ask the user to select one or multiple from a list of choices. Note: delimit your choices by space, comma or semi colon.
+    """
+    Ask the user to select one or multiple from a list of choices,
+    delimited by space, comma or semi colon.
 
     Will loop until:
-        * the user enters a valid index
+
+        * the user enters a valid selection
         * or leaves the prompt empty
 
     In the last case, `None` will be returned

docs/index.rst

@@ -316,21 +316,21 @@ Asking for user input
   .. versionchanged:: 0.7
 
        The :py:exc:`KeyboardInterrupt` exception is no longer caught by this function.
-       
+
 .. autofunction:: select_choices
 
 
   ::
 
       >>> choices = ["apple", "banana", "orange"]
-      >>> fruit = cli_ui.ask_choice("Select several fruits", choices=choices)
+      >>> fruits = cli_ui.ask_choice("Select several fruits", choices=choices)
       :: Select a fruit
         1 apple
         2 banana
         3 orange
-      <1,2>
-      >>> fruit
-      ('apple, 'banana')
+      <1, 2>
+      >>> fruits
+      ['apple', 'banana']
 
 
 .. autofunction:: ask_yes_no