From 4752eb39b4229249d52e8397ec87c93db4334e4a Mon Sep 17 00:00:00 2001
From: Raghav Jajodia <jajodia.raghav@gmail.com>
Date: Sat, 4 Mar 2017 15:00:10 +0530
Subject: [PATCH] help: Added user docs for change of email address.

---
 .../zerver/help/change-your-email-address.md  | 24 +++++++++++++++++++
 ...low-users-to-change-their-email-address.md | 19 +++++++++++++++
 templates/zerver/help/index.md                |  2 ++
 3 files changed, 45 insertions(+)
 create mode 100644 templates/zerver/help/change-your-email-address.md
 create mode 100644 templates/zerver/help/disallow-users-to-change-their-email-address.md

diff --git a/templates/zerver/help/change-your-email-address.md b/templates/zerver/help/change-your-email-address.md
new file mode 100644
index 0000000000..caeb0523b3
--- /dev/null
+++ b/templates/zerver/help/change-your-email-address.md
@@ -0,0 +1,24 @@
+# Change your email address
+
+If enabled by Zulip organization administrator, you can change your email address
+using the following steps.
+
+{!go-to-the.md!} [Your account](/#settings/your-account)
+{!settings.md!}
+
+2. Click on the **[Change]** link beside your email address.
+
+    !!! warn ""
+        **Note:** If you do not see the [Change] link,
+        it is probably because your organization's administrators
+        have disabled change of email addresses.
+        If that's the case, then you need to ask them to
+        allow users to change their email address.
+
+3. Change your email in the **Email** field.
+
+4. Click on the **Change** button to receive a confirmation mail.
+
+5. Click on the **Confirmation link** send to your new email address.
+
+Congratulations! You have updated your email address.
diff --git a/templates/zerver/help/disallow-users-to-change-their-email-address.md b/templates/zerver/help/disallow-users-to-change-their-email-address.md
new file mode 100644
index 0000000000..991071000f
--- /dev/null
+++ b/templates/zerver/help/disallow-users-to-change-their-email-address.md
@@ -0,0 +1,19 @@
+# Prevent users from changing their email address
+
+{!admin-only.md!}
+
+By default, any user can change their own email address by going
+through an email confirmation process that confirms they own both the
+account and new email address.
+
+For organizations that are using LDAP or another a Single Sign-On
+solution where a user's account is managed elsewhere, you can enable a
+setting that prevents them from changing their own email address via
+the Zulip UI.
+
+{!go-to-the.md!} [Organization settings](/#administration/organization-settings)
+{!admin.md!}
+
+2. Select the **Prevent users from changing their email address** checkbox.
+
+{!save-changes.md!} organization settings.
diff --git a/templates/zerver/help/index.md b/templates/zerver/help/index.md
index d0586bfb73..1820b9e964 100644
--- a/templates/zerver/help/index.md
+++ b/templates/zerver/help/index.md
@@ -18,6 +18,7 @@ as an **organization**.
 
 ## Account Basics
 * [Change your name](/help/change-your-name)
+* [Change your email address](/help/change-your-email-address)
 * [Change your password](/help/change-your-password)
 * [Change your settings](/help/change-your-settings)
 * [Change your avatar](/help/change-your-avatar)
@@ -123,6 +124,7 @@ as an **organization**.
 * [Allow anyone to join without an invitation](/help/allow-anyone-to-join-without-an-invitation)
 * [Only allow admins to invite new users](/help/only-allow-admins-to-invite-new-users)
 * [Only allow admins to create new streams](/help/only-allow-admins-to-create-new-streams-feature)
+* [Prevent users from changing their email address](/help/disallow-users-to-change-their-email-address)
 * [Restrict editing of old messages and topics](/help/restrict-editing-of-old-messages-and-topics)
 * [Change the default language for your organization](/help/change-the-default-language-for-your-organization)
 * [Add custom emoji](/help/add-custom-emoji)