Async rendering docs.

Author: alexanderby

SUMMARY.md

@@ -25,6 +25,7 @@
    * [Visual encoding / Color](advanced/encoding.md)
    * [Visual encoding / Size](advanced/visual_encoding__size.md)
    * [Scatterplot Matrices](advanced/splom.md)
+   * [Rendering performance](advanced/performance.md)
 * [Plugins](plugins/README.md)
    * [Custom Ticks](plugins/customticks.md)
    * [Tooltip](plugins/tooltip.md)

advanced/performance.md

@@ -0,0 +1,20 @@
+## Rendering performance
+
+Drawing big data can be slow.
+
+To prevent browser freeze, several chart settings were introduced in Taucharts v0.10.0:
+``` javascript
+settings: {
+    asyncRendering: false,
+    renderingTimeout: 10000,
+    syncRenderingInterval: 50,
+    handleRenderingErrors: true
+}
+```
+
+* Setting `asyncRendering: true` will make a chart render asynchronously by small synchronous chunks, making a browser more responsive to user interactions.
+* `renderingTimeout` is an interval (ms) after which the rendering will be paused, and user will be prompt to continue or cancel. Setting this option to `0` will disable the pause.
+* `syncRenderingInterval` is a minimal interval of synchronous rendering chunks.
+* Setting `handleRenderingErrors: false` will make it easier to debug possible rendering errors.
+
+Asynchronous rendering prevents browser from freeze, but will not prevent from running out of memory.

basic/settings.md

@@ -29,4 +29,12 @@ https://jsfiddle.net/taucharts/9hzfoqop/
 These settings control minimal padding between tick text and tick border on ordinal scale.
 It is 0.25 by default.
 See example where yDensityPadding is set to 30 and xDensityPadding is set to 1:
-https://jsfiddle.net/taucharts/p3jtgt4j/
+https://jsfiddle.net/taucharts/p3jtgt4j/
+
+#### animationSpeed
+
+Controls the duration of elements animation. By default it is `750` ms. Set `0` to disable animation.
+
+#### asyncRendering
+
+Setting `asyncRendering: true` will make a browser more responsive, when rendering charts with large amount of data and facets. See more info about asynchronous rendering [here](../advanced/performance.md).