[KEYCLOAK-994] - Identity broker documentation.

distribution/examples-docs-zip/build.xml

@@ -34,6 +34,14 @@
                 <exclude name="**/subsystem-config.xml"/>
             </fileset>
         </copy>
+        <copy todir="target/examples/broker" overwrite="true">
+            <fileset dir="../../examples/broker">
+                <exclude name="**/target/**"/>
+                <exclude name="**/*.iml"/>
+                <exclude name="**/*.unconfigured"/>
+                <exclude name="**/subsystem-config.xml"/>
+            </fileset>
+        </copy>
         <copy todir="target/examples/js-console" overwrite="true">
             <fileset dir="../../examples/js-console">
                 <exclude name="**/target/**"/>

docbook/reference/en/en-US/master.xml

@@ -21,12 +21,7 @@
                 <!ENTITY Logout SYSTEM "modules/logout.xml">
                 <!ENTITY SAML SYSTEM "modules/saml.xml">
                 <!ENTITY JAAS SYSTEM "modules/jaas.xml">
-                <!ENTITY SocialConfig SYSTEM "modules/social-config.xml">
+                <!ENTITY IdentityBroker SYSTEM "modules/identity-broker.xml">
-                <!ENTITY SocialFacebook SYSTEM "modules/social-facebook.xml">
-                <!ENTITY SocialGitHub SYSTEM "modules/social-github.xml">
-                <!ENTITY SocialGoogle SYSTEM "modules/social-google.xml">
-                <!ENTITY SocialTwitter SYSTEM "modules/social-twitter.xml">
-                <!ENTITY SocialProviderSPI SYSTEM "modules/social-spi.xml">
                 <!ENTITY Themes SYSTEM "modules/themes.xml">
                 <!ENTITY Migration SYSTEM "modules/MigrationFromOlderVersions.xml">
                 <!ENTITY Email SYSTEM "modules/email.xml">
@@ -105,21 +100,7 @@ This one is short
         &JAAS;
     </chapter>
 
-    <chapter>
+    &IdentityBroker;
-        <title>Social</title>
-        <para>
-            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;
-        &SocialGitHub;
-        &SocialGoogle;
-        &SocialTwitter;
-        &SocialProviderSPI;
-    </chapter>
-
     &Themes;
 
     <chapter>

docbook/reference/en/en-US/modules/social-github.xml

@@ -2,13 +2,13 @@
     <title>GitHub</title>
     <para>
         To enable login with GitHub you first have to create an application in
-        <ulink url="https://github.com/settings/applications">GitHub Settings</ulink>. Then you need to copy
+        <link xlink:href="https://github.com/settings/applications">GitHub Settings</link>. Then you need to copy
         the client id and secret into the Keycloak Admin Console.
     </para>
     <orderedlist>
         <listitem>
             <para>
-                Log in to <ulink url="https://github.com/settings/applications">GitHub Settings</ulink>. Click the
+                Log in to <link xlink:href="https://github.com/settings/applications">GitHub Settings</link>. Click the
                 <literal>Register new application</literal> button. Use any value for <literal>Application name</literal>,
                 <literal>Homepage URL</literal> and <literal>Application Description</literal> you want. In <literal>Authorization callback URL</literal>
                 enter the <link linkend="social-callbackurl">social callback url</link> for your realm. Click the
@@ -18,7 +18,7 @@
         <listitem>
             <para>
                 Copy <literal>Client ID</literal> and <literal>Client secret</literal> from the
-                <ulink url="https://github.com/settings/applications">GitHub Settings</ulink> into the settings
+                <link xlink:href="https://github.com/settings/applications">GitHub Settings</link> into the settings
                 page in the Keycloak Admin Console as the <literal>Key</literal> and <literal>Secret</literal>. Then click
                 <literal>Save</literal> in the Keycloak Admin Console to enable login with GitHub.
             </para>

docbook/reference/en/en-US/modules/social-twitter.xml

@@ -2,13 +2,13 @@
     <title>Twitter</title>
     <para>
         To enable login with Twtter you first have to create an application in the
-        <ulink url="https://dev.twitter.com/apps">Twitter Developer Console</ulink>. Then you need to copy
+        <link xlink:href="https://dev.twitter.com/apps">Twitter Developer Console</link>. Then you need to copy
         the consumer key and secret into the Keycloak Admin Console.
     </para>
     <orderedlist>
         <listitem>
             <para>
-                Log in to the <ulink url="https://dev.twitter.com/apps">Twitter Developer Console</ulink>. Click the
+                Log in to the <link xlink:href="https://dev.twitter.com/apps">Twitter Developer Console</link>. Click the
                 <literal>Create a new application</literal> button. Use any value for <literal>Name</literal>,
                 <literal>Description</literal> and <literal>Website</literal> you want. Insert the social callback url
                 in <literal>Callback URL</literal>. Then click <literal>Create your Twitter application</literal>.
@@ -23,7 +23,7 @@
         <listitem>
             <para>
                 Now click <literal>API Keys</literal> tab. Copy <literal>API key</literal> and <literal>API secret</literal> from the
-                <ulink url="https://dev.twitter.com/apps">Twitter Developer Console</ulink> into the settings
+                <link xlink:href="https://dev.twitter.com/apps">Twitter Developer Console</link> into the settings
                 page in the Keycloak Admin Console as the <literal>Key</literal> and <literal>Secret</literal>. Then click
                 <literal>Save</literal> in the Keycloak Admin Console to enable login with Twitter.
             </para>