add the use of 'runner.traceback' and 'runner.elapsed_time()' to the docs

Author: basnijholt

adaptive/runner.py

@@ -338,6 +338,8 @@ def _run(self):
             self._cleanup()
 
     def elapsed_time(self):
+        """Return the total time elapsed since the runner
+        was started."""
         if self.end_time is None:
             # This shouldn't happen if the BlockingRunner
             # correctly finished.
@@ -532,6 +534,8 @@ async def _run(self):
             self._cleanup()
 
     def elapsed_time(self):
+        """Return the total time elapsed since the runner
+        was started."""
         if self.task.done():
             end_time = self.end_time
             if end_time is None:

docs/source/tutorial/tutorial.advanced-topics.rst

@@ -298,6 +298,15 @@ raise the exception with the stack trace:
 
     runner.task.result()
 
+
+You can also check ``runner.tracebacks`` which is a mapping from
+point → traceback.
+
+.. jupyter-execute::
+
+    for point, tb in runner.tracebacks.items():
+        print(f'point: {point}:\n {tb}')
+
 Logging runners
 ~~~~~~~~~~~~~~~
 
@@ -337,10 +346,16 @@ set of operations on another runner:
 
     learner.plot().Scatter.I.opts(style=dict(size=6)) * reconstructed_learner.plot()
 
-Timing functions
-~~~~~~~~~~~~~~~~
+Adding coroutines
+-----------------
+
+In the following example we'll add a `~asyncio.Task` that times the runner.
+This is *only* for demonstration purposes because one can simply
+check ``runner.elapsed_time()`` or use the ``runner.live_info()``
+widget to see the time since the runner has started.
 
-To time the runner you **cannot** simply use
+So let's get on with the example. To time the runner
+you **cannot** simply use
 
 .. code:: python