update docs (#874)

CHANGELOG.rst

@@ -40,6 +40,8 @@ Added
     - REST API views (#1350)
     - ``get_project()`` helpers in ``TimelineEvent`` and ``TimelineEventObjectRef`` (#1350)
     - Optional pagination for REST API list views (#1313)
+- **Userprofile**
+    - Additional email address management and verification (#874)
 
 Changed
 -------

docs/source/app_userprofile.rst

@@ -95,3 +95,26 @@ Receive Email for Project Membership Updates
 
 In the development setup, the SODAR Core example site apps also provide
 additional settings for demonstrating settings features.
+
+
+Additional Emails
+=================
+
+The user can configure additional emails for their user account in case they
+want to receive automated emails to addresses other than their primary address.
+The user profile view displays additional emails and provides controls for
+managing these addresses.
+
+.. hint::
+
+    Managing addresses is only possible on a source site. On a target site,
+    emails will be visible but not mofifiable.
+
+A new additional email address can be added with a form accessible by clicking
+on the :guilabel:`Add Email` button. After creation, a verification email will
+be sent to the specified address. Opening a link contained in the email and
+logging into the site will verify the email. Only verified email addresses will
+receive automated emails from the site.
+
+For each email address displayed in the list, there are controls to re-send the
+verification email (in case of an unverified email) and deleting the address.

docs/source/major_changes.rst

@@ -23,6 +23,7 @@ Release Highlights
 - Add timeline REST API
 - Add optional pagination for REST API list views
 - Add admin alert email sending to all users
+- Add improved additional email address management and verification
 - Add user opt-out settings for email notifications
 - Add target site user UUID updating in remote sync
 - Add remote sync of existing target local users