diff --git a/docsite/rst/playbooks_conditionals.rst b/docsite/rst/playbooks_conditionals.rst
index 21dd5ca6d22..3ad12d08575 100644
--- a/docsite/rst/playbooks_conditionals.rst
+++ b/docsite/rst/playbooks_conditionals.rst
@@ -44,13 +44,20 @@ decide to do something conditionally based on success or failure::
       - command: /bin/false
         register: result
         ignore_errors: True
+
       - command: /bin/something
         when: result|failed
+
+      # In older versions of ansible use |success, now both are valid but succedded uses the correct tense.
       - command: /bin/something_else
         when: result|succeeded
+
       - command: /bin/still/something_else
         when: result|skipped
 
+
+.. note:: the filters have been updated in 2.1 so both `success` and `succeded` work (`fail`/`failed`, etc).
+
 Note that was a little bit of foreshadowing on the 'register' statement.  We'll get to it a bit later in this chapter.
 
 As a reminder, to see what facts are available on a particular system, you can do::