diff --git a/filter/censor/README.txt b/filter/censor/README.txt
new file mode 100644
index 00000000000..bbb49afed2d
--- /dev/null
+++ b/filter/censor/README.txt
@@ -0,0 +1,17 @@
+//////////////////////////
+//                      //
+//  Censorship Filter   //
+//                      //
+//////////////////////////
+
+This is a very simple Text Filter that searches text 
+being output to the screen, replacing "bad" words 
+with other words.
+
+To activate this filter, add a line like this to your
+config.php:
+
+   $CFG->textfilter1 = 'filter/censor/censor.php';
+
+
+To customise the word list, edit cursor.php.