diff --git a/docbook/reference/en/en-US/master.xml b/docbook/reference/en/en-US/master.xml
index f2c39208f5..f3f6f40627 100755
--- a/docbook/reference/en/en-US/master.xml
+++ b/docbook/reference/en/en-US/master.xml
@@ -64,7 +64,9 @@
     <chapter>
         <title>Social</title>
         <para>
-            Social login description
+            Keycloak makes it easy to let users log in to your application using an existing account with a social network.
+            Currently Facebook, Google and Twitter is supported with more planned for the future. There's also a Social
+            Provider SPI that makes it relatively simple to add additional social networks.
         </para>
         &SocialConfig;
         &SocialFacebook;
diff --git a/docbook/reference/en/en-US/modules/email.xml b/docbook/reference/en/en-US/modules/email.xml
index 692952ab0e..91f273b254 100644
--- a/docbook/reference/en/en-US/modules/email.xml
+++ b/docbook/reference/en/en-US/modules/email.xml
@@ -6,8 +6,8 @@
     </para>
 
     <para>
-        To configure your SMTP server, open the <literal>Keycloak Admin Console</literal>, select your realm from the drop-down box in the
-        top-menu, then click on <literal>Email</literal> in the sub-menu.
+        To configure your SMTP server, open the <literal>Keycloak Admin Console</literal>, select your realm from the drop-down box in the top left corner.
+        Then click on <literal>Email</literal> in the menu at the top.
     </para>
 
     <para>
diff --git a/docbook/reference/en/en-US/modules/social-config.xml b/docbook/reference/en/en-US/modules/social-config.xml
index 3de13281dc..159e7c9125 100644
--- a/docbook/reference/en/en-US/modules/social-config.xml
+++ b/docbook/reference/en/en-US/modules/social-config.xml
@@ -1,9 +1,25 @@
 <section id="social-config">
     <title>Social Login Config</title>
     <para>
-        Social login config description
+        To enable log in with a social network you need to enable social login for your realm and configure one or more
+        social providers.
     </para>
 
+    <section>
+        <title>Enable social login</title>
+        <para>
+            To configure your SMTP server, open the <literal>Keycloak Admin Console</literal>, select your realm from the
+            drop-down box in the top left corner. In the <literal>Login Options</literal> section click on
+            <literal>Social login</literal> to set it to <literal>ON</literal>. Click save settings, then click on
+            <literal>Social</literal> in the menu at the top.
+        </para>
+        <para>
+            To enable a social provider select the provider you want from the drop-down and click on
+            <literal>Add Provider</literal>. Then continue to the section below that provides specific instructions for
+            the provider you are adding.
+        </para>
+    </section>
+
     <section id="social-callbackurl">
         <title>Social Callback URL</title>
         <para>