Merge pull request #105 from ianhi/master

rephrase hold_canvas explanation

Author: martinRenou

docs/source/basic_usage.rst

@@ -62,14 +62,12 @@ Optimizing drawings
 -------------------
 
 By default, the Python ``Canvas`` object sends all the drawings commands like ``fill_rect``
-and ``arc`` one by one through the widgets communication layer. This communication is
-limited to 1000 commands/s if you did not change internal Jupyter parameters, and it can
-be extremely slow to send commands one after the other.
-
-We provide a ``hold_canvas`` context manager which allows you to hold all the commands and
-send them in a single batch at the end.
-
-``hold_canvas`` must be used without moderation.
+and ``arc`` one by one through the widgets communication layer. This communication is limited
+to 1000 commands/s and it can be extremely slow to send commands one after the other. 
+You can increase this limit via internal Jupyter `parameters <https://github.com/martinRenou/ipycanvas/issues/102>`_,
+however this is not recommended as it can lead to instability. Instead we provide a ``hold_canvas`` 
+context manager which allows you to hold all the commands and send them in a single batch at the end. For
+optimal performance you should try to use ``hold_canvas`` as much as possible.
 
 .. code:: Python