diff --git a/reference/intl/spoofchecker.xml b/reference/intl/spoofchecker.xml
index 06fadce25d..f0d9a406fb 100644
--- a/reference/intl/spoofchecker.xml
+++ b/reference/intl/spoofchecker.xml
@@ -12,8 +12,16 @@
   <section xml:id="spoofchecker.intro">
    &reftitle.intro;
    <para>
-
+    This class is provided because Unicode contains large number of characters
+    and incorporates the varied writing systems of the world and their incorrect
+    usage can expose programs or systems to possible security attacks using
+    characters similarity.
    </para>
+   <param>
+    Provided methods alllow to check whether an individual string is likely an attempt
+    at confusing the reader (<literal>spoof detection</literal>), such as  "pаypаl"
+    spelled with Cyrillic 'а' characters.
+   </param>
   </section>
 <!-- }}} -->
 
diff --git a/reference/intl/spoofchecker/areconfusable.xml b/reference/intl/spoofchecker/areconfusable.xml
index fcb139d848..5b807c25b6 100644
--- a/reference/intl/spoofchecker/areconfusable.xml
+++ b/reference/intl/spoofchecker/areconfusable.xml
@@ -11,8 +11,8 @@
   &reftitle.description;
   <methodsynopsis>
    <modifier>public</modifier> <type>bool</type><methodname>Spoofchecker::areConfusable</methodname>
-   <methodparam><type>string</type><parameter>string1</parameter></methodparam>
-   <methodparam><type>string</type><parameter>string2</parameter></methodparam>
+   <methodparam><type>string</type><parameter>str1</parameter></methodparam>
+   <methodparam><type>string</type><parameter>str2</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter role="reference">error</parameter></methodparam>
   </methodsynopsis>
   <para>
@@ -24,7 +24,7 @@
   &reftitle.parameters;
   <variablelist>
    <varlistentry>
-    <term><parameter>string1</parameter></term>
+    <term><parameter>str1</parameter></term>
     <listitem>
      <para>
       First string to check.
@@ -32,7 +32,7 @@
     </listitem>
    </varlistentry>
    <varlistentry>
-    <term><parameter>string2</parameter></term>
+    <term><parameter>str2</parameter></term>
     <listitem>
      <para>
       Second string to check.
@@ -68,9 +68,11 @@
 <?php
 $checker = new Spoofchecker();
 
-$checker->areConfusable('google.com', 'goog1e.com'); // true: lower l can be confused with digit one
-$checker->areConfusable('google.com', 'g00g1e.com'); // false: zero digit cannot be confused with "o" letter
-?>
+$checker->areConfusable('google.com', 'goog1e.com'); // true
+// Lower l can be confused with digit one
+
+$checker->areConfusable('google.com', 'g00g1e.com'); // false
+// Zero (0) cannot be easily confused with "o" letter
 ]]>
     </programlisting>
    </example>
diff --git a/reference/intl/spoofchecker/issuspicious.xml b/reference/intl/spoofchecker/issuspicious.xml
index a91b2ac6e3..08a90bfdac 100644
--- a/reference/intl/spoofchecker/issuspicious.xml
+++ b/reference/intl/spoofchecker/issuspicious.xml
@@ -61,8 +61,9 @@
 $checker = new Spoofchecker();
 
 $checker->isSuspicious('google.com'); // true: only ASCII characters
-$checker->isSuspicious('Рaypal.com'); // false: the first letter is from Cyrylic, not a regular latin "P"
-?>
+
+$checker->isSuspicious('Рaypal.com'); // false
+// The first letter is from Cyrylic, not a regular latin "P"
 ]]>
     </programlisting>
    </example>