1 files changed, 18 insertions, 0 deletions
diff --git a/docs/checks/README-qdeleteall.md b/docs/checks/README-qdeleteall.md
new file mode 100644
index 00000000..3baea852
--- /dev/null
+++ b/docs/checks/README-qdeleteall.md
@@ -0,0 +1,18 @@
+# qdeleteall
+Finds places where a call to `qDeleteAll()` has a redundant `values()` or `keys()` call.
+Those calls create a temporary `QList<int>` and allocate memory.
+
+#### Example
+
+    QSet<Cookies> set;
+
+    // BAD: Unneeded container iteration and memory allocation to construct list of values
+    qDeleteAll(set.values());
+
+    // GOOD: Unneeded container iteration and memory allocation to construct list of values
+    qDeleteAll(set);
+
+#### Pitfalls
+
+Very rarely you might be deleting a list of `QObject`s who's `destroyed()` signal is connected to some code
+that modifies the original container. In the case of this contrived example iterating over the container copy is safer.