diff --git a/docs/features.rst b/docs/features.rst
index 1eb00d68..c8e46263 100644
--- a/docs/features.rst
+++ b/docs/features.rst
@@ -143,10 +143,10 @@ __ https://docs.python.org/3/library/re.html#re.sub
 
 Remove parent value only if it matches regular expression is done
 using  the ``-~`` suffix. If value matches any of provided
-`regular expressions`__ it is removed. In the case of parent value
-being a list the item is removed from this list. If the parent value
-is a string value is set to the empty string. If parent value is
-a dictionary, the key is removed. These regular expressions can
+`regular expressions`__ it is removed. If the parent value
+is a list, the matching item is removed from this list. If the parent value
+is a string, the value is set to an empty string. If the parent value is
+a dictionary, the matching key is removed. These regular expressions can
 be just a single item or a list of strings::
 
     description-~: '.*'