diff --git a/README.md b/README.md
index b93261bb4..c0c7dd70a 100644
--- a/README.md
+++ b/README.md
@@ -101,6 +101,8 @@ pipeline {
 }
 ```
 
+Setting `quantity` to `null`, `0` or a smaller number, all available resources of that label are locked at once.
+
 #### Take first position in queue
 
 ```groovy
diff --git a/src/doc/examples/scripted-vs-declarative-pipeline.md b/src/doc/examples/scripted-vs-declarative-pipeline.md
index d1624d0d1..a28e8be01 100644
--- a/src/doc/examples/scripted-vs-declarative-pipeline.md
+++ b/src/doc/examples/scripted-vs-declarative-pipeline.md
@@ -32,3 +32,8 @@ node() {
     }
 }
 ```
+
+## Pitfalls
+
+Setting `quantity` to `null`, `0` or a smaller number, all available resources of that label are locked at once.
+See [#198 - Lock All resources by setting quantity to 0 is not documented](https://github.com/jenkinsci/lockable-resources-plugin/issues/198).