diff --git a/docs/fields.md b/docs/fields.md
index a6d840425..0d951b4aa 100644
--- a/docs/fields.md
+++ b/docs/fields.md
@@ -339,6 +339,11 @@ patchesStrategicMerge:
             image: nignx:latest
 ```
 
+Note that kustomize does not support more than one patch
+for the same object that contain a _delete_ directive. To remove
+several fields / slice elements from an object create a single
+patch that performs all the needed deletions.
+
 ### patchesJson6902
 
 Each entry in this list should resolve to
diff --git a/docs/glossary.md b/docs/glossary.md
index 03b3abcc6..349f78b60 100644
--- a/docs/glossary.md
+++ b/docs/glossary.md
@@ -376,9 +376,8 @@ value is a list.
 
 To change this
 default behavior, add a _directive_.  Recognized
-directives include _replace_ (the default), _merge_
-(avoid replacing a list), _delete_ and a few more
-(see [these notes][strategic-merge]).
+directives in YAML patches are _replace_ (the default)
+and _delete_ (see [these notes][strategic-merge]).
 
 Note that for custom resources, SMPs are treated as
 [json merge patches][JSONMergePatch].