diff --git a/README.adoc b/README.adoc
index 787937d..1c4b8b1 100644
--- a/README.adoc
+++ b/README.adoc
@@ -473,9 +473,27 @@ doc:2:test_obvious_matching_with_assert_not_matches()
 
 === *assert_no_diff*
 
-    assert_no_diff <expected-file> <actual-file> [message]
+    assert_no_diff <expected> <actual> [message]
 
-Asserts that the content of `expected-file` matches the content of `actual-file`.
+Asserts that the content of the file _actual_ does not have any differences to the one _expected_.
+
+```test
+test_obvious_notmatching_with_assert_no_diff(){
+  assert_no_diff bash_unit README.adoc "content of 'README.adoc' should be the same as 'bash_unit'"
+}
+test_obvious_matching_with_assert_assert_no_diff(){
+  assert_no_diff bash_unit bash_unit
+}
+
+```
+
+```output
+	Running test_obvious_matching_with_assert_assert_no_diff ... SUCCESS
+	Running test_obvious_notmatching_with_assert_no_diff ... FAILURE
+content of 'README.adoc' should be the same as 'bash_unit'
+ expected 'README.adoc' to be identical to 'bash_unit' but was different
+doc:2:test_obvious_notmatching_with_assert_no_diff()
+```
 
 == *fake* function