[gnome-user-docs] Update enterprise-login.page

[Petr Kovář <pmkovar src gnome org>]

commit 3bc836af26a120219de202325de4376a527921b1
Author: Petr Kovar <pkovar redhat com>
Date:   Tue Jan 28 17:21:01 2014 +0000

    Update enterprise-login.page

 system-admin-guide/C/enterprise-login.page |  131 +++++++++++++++++++++-------
 1 files changed, 101 insertions(+), 30 deletions(-)
---
diff --git a/system-admin-guide/C/enterprise-login.page b/system-admin-guide/C/enterprise-login.page
index 393cdb4..1339831 100644
--- a/system-admin-guide/C/enterprise-login.page
+++ b/system-admin-guide/C/enterprise-login.page
@@ -1,47 +1,118 @@
 <page xmlns="http://projectmallard.org/1.0/";
       xmlns:its="http://www.w3.org/2005/11/its";
-      type="topic" style="task"
-      id="enterprise-login">
+      type="topic" style="task" id="enterprise-login">
 
   <info>
     <link type="guide" xref="index#session" />
-    <revision version="0.1" date="2013-09-18" status="stub"/>
+    <revision version="0.1" date="2014-01-28" status="draft"/>
 
     <credit type="editor">
       <name>Petr Kovar</name>
       <email its:translate="no">pknbe volny cz</email>
-      <years>2013</years>
+      <years>2014</years>
     </credit>
 
-    <desc>Use your Enterprise credentials to log into the GNOME Desktop.</desc>
-   </info>
+    <desc>Use your Active Directory or IPA domain credentials to log into
+    GNOME.</desc>
+  </info>
 
-  <title>Use your Enterprise credentials to log into GNOME</title>
-  
-  <p>Once you have a working Active Directory domain available, you can
-   configure the GNOME Desktop to join the Active Directory domain using your
-   Enterprise credentials. Make sure that you have set up a domain user account
-   before proceeding.</p>
+  <title>Use enterprise credentials to log into GNOME</title>
   
+  <p>If your network has an Active Directory or IPA domain available, and you
+    have a domain account, you can use your domain credentials to log into GNOME.
+  </p>
+  <p>If the machine has been successfully configured for
+    domain accounts, users can log into GNOME using their accounts. At the
+    login prompt, type the domain user name followed
+    by an <sys>@</sys> sign, and then your domain name. For example, if
+    your domain name is <var>example.com</var> and the user name
+    is <var>User</var>, type:</p>
+  <screen><input>User example com</input></screen>
+  <p>In cases where the machine is already configured for domain accounts, you
+    should see a helpful hint describing the login format.</p>
+
+  <section id="enterprise-login-welcome-screens">
+    <title>Use enterprise credentials during Welcome screens</title>
+    <p>If you have not yet configured the machine for enterprise
+      credentials, you can do so at the <gui>Welcome</gui> screens that
+      are part of the <app>GNOME Initial Setup</app> program.</p>
+    <steps>
+    <title>Configure enterprise credentials</title>
+      <item>
+        <p>At the <gui>Login</gui> welcome screen, choose
+          <gui>Use Enterprise Login</gui>.</p>
+      </item>
+      <item>
+        <p>Type the name of your domain in the <gui>Domain</gui> field
+          if it is not already prefilled.</p>
+      </item>
+      <item>
+        <p>Type your domain account user and password in the relevant fields.
+        </p>
+      </item>
+      <item>
+        <p>Click <gui>Next</gui>.</p>
+      </item>
+    </steps>
+    <p>Depending on how the domain is configured, a prompt may show up asking for
+      the domain administrator's name and password in order to proceed.</p>
+  </section>
+  <section id="enterprise-login-change-to">
+    <title>Change to use enterprise credentials to log into GNOME</title>
+    <p>If you have already completed initial setup, and wish to start a domain
+      account to log into GNOME, then you can accomplish this from the Users
+      panel in the GNOME Settings.</p>
   <steps>
-       <title>Join an Active Directory domain</title>
-       <item><p>Click your name on the top bar and select <gui>Settings</gui>
-        from the menu.</p></item>
-       <item><p>From the list of items, select <gui>Users</gui>.</p></item>
-       <item><p>Click the <gui>Unlock</gui> button and type the administrator's
-        password.</p></item>
-       <item><p>Click the <gui>[+]</gui> button in the lower left of the window.</p>
-       </item>
-       <item><p>Select the <gui>Enterprise Login</gui> pane.</p></item>
-       <item><p>Enter the domain, user, and password for your Enterprise account,
-        and click <gui>Add</gui>.</p></item>
-       <item><p>To check that the domain is properly configured, run the
-        following command in the terminal:</p>
-       <screen its:translate="no">
-        <output style="prompt">$ </output><input>realm list</input>
-        </screen>
-        <p>Verify that the output lists the Active Directory domain.</p>
-       </item>
+    <title>Configure enterprise credentials</title>
+    <item>
+      <p>Open the <gui xref="help:gnome-help/shell-terminology">Activities</gui>
+      overview and
+      start typing <gui>Users</gui>.</p>
+    </item>
+    <item>
+      <p>Click on <gui>Users</gui> to open the panel.</p>
+    </item>
+    <item>
+      <p>Click the <gui>Unlock</gui> button and type the computer
+    administrator's password.</p>
+    </item>
+    <item>
+      <p>Click the <gui>[+]</gui> button in the lower left of
+    the window.</p>
+    </item>
+    <item>
+      <p>Click the <gui>Enterprise Login</gui> button.</p>
+    </item>
+    <item>
+      <p>Enter the domain, user, and password for your Enterprise account,
+     and click <gui>Add</gui>.</p>
+   </item>
   </steps>
+  <p>Depending on how your domain is configured, a prompt may show up asking for
+    the domain administrator's name and password in order to proceed.
+    </p>
+  </section>
+  <section id="enterprise-login-troubleshoot">
+    <title>Troubleshoot and advanced setup</title>
+    <p>The <cmd>realm</cmd> command and its various subcommands can be used
+      to troubleshoot the enterprise login feature. For example, to see whether
+      the machine has been configured for enterprise logins, run the following
+      command:</p>
+    <screen><output>$ </output><input>realm list</input></screen>
+    <p>Network administrators are encouraged to pre-join workstations to a
+      relevant domain. This can be done using the kickstart <cmd>realm join</cmd>
+      command, or running <cmd>realm join</cmd> in an automated fashion
+      from a script.</p>
+  </section>
+  <section id="enterprise-login-more-information">
+     <title>Get more information</title>
+   <list>
+    <item>
+      <p>The realmd <link href="http://www.freedesktop.org/software/realmd/docs/";>
+        Administrative Guide</link> provides more detailed information on using
+        the enterprise login feature.</p>
+    </item>
+   </list>
+  </section>
 
 </page>