Some words about perfomance (fixes #133

jieter · May 23, 2016 · ec57add · ec57add
1 parent ae0d67c
commit ec57add
Show file tree

Hide file tree

Showing 2 changed files with 13 additions and 0 deletions.
diff --git a/docs/pages/getting-started.rst b/docs/pages/getting-started.rst
@@ -14,3 +14,4 @@ in your template setting ``OPTIONS``.
 .. toctree::
     tutorial
     table-data
+    performance
diff --git a/docs/pages/performance.rst b/docs/pages/performance.rst
@@ -0,0 +1,12 @@
+Performance
+-----------
+
+Django-tables tries to be efficient in displaying big datasets. It tries to
+avoid converting the `~django.db.models.query.QuerySet` instances to lists by
+using SQL to slice the data and should be able to handle datasets with 100k
+records without a problem.
+
+However, when using one of the customisation methods described in this
+documentation, there is lot's of oppurtunity to introduce slowness.
+If you experience that, try to strip the table of customisations and re-add them
+one by one, checking for performance after each step.