feat: document how to share pii to lti components (#1368)

* feat: document how to share pii to lti components

The setting to share user emails and usernames with LTI components
is behind a flag that can be set from the Django admin.
Add documentation for how to set this flag.

Private-ref: https://tasks.opencraft.com/browse/BB-6337

* fixup! feat: document how to share pii to lti components

Add links and chart in response to review

Author: samuelallan72

source/_images/site_ops_how_tos/lti_pii_sharing_admin_1.png

@@ -0,0 +1,41 @@
+.. _Allow sharing PII to LTI Components:
+
+Allow sharing PII to LTI Components
+###################################
+
+.. tags:: site operator, how-to
+
+The LTI component block has settings to share the user's email or username with the LTI application.
+By default, these settings are disabled for privacy reasons.
+The settings may be enabled per-course by an administrator, using the Django admin console:
+
+#. With a system administrator account, navigate to the django admin console, and find the "Course allow pii sharing in lti flags" item.
+   Click the text on the left for the item to navigate to the page with the list of these flags.
+   From this page, you can add, modify, or delete flags.
+
+   .. image:: /_images/site_ops_how_tos/lti_pii_sharing_admin_1.png
+      :alt: A screenshot of the Django admin console showing the "Course allow pii sharing in lti flags" menu item.
+
+#. Click the button to add a new flag:
+
+   .. image:: /_images/site_ops_how_tos/lti_pii_sharing_admin_2.png
+      :alt: A screenshot of the Django admin console showing the button to "add course allow pii sharing in lti flag".
+
+#. In the new flag form, enter the ID for the course you wish to enable this for, and ensure the "Enabled" field is checked.
+
+   .. image:: /_images/site_ops_how_tos/lti_pii_sharing_admin_3.png
+      :alt: A screenshot of the Django admin console showing the form to add an enabled flag for a particular course id.
+
+#. Finally, save the form.
+
+.. seealso::
+
+ :ref:`LTI Component settings` (reference)
+
+**Maintenance chart**
+
++--------------+-------------------------------+----------------+--------------------------------+
+| Review Date  | Working Group Reviewer        |   Release      |Test situation                  |
++--------------+-------------------------------+----------------+--------------------------------+
+|              |                               |                |                                |
++--------------+-------------------------------+----------------+--------------------------------+

source/_images/site_ops_how_tos/lti_pii_sharing_admin_2.png

@@ -171,10 +171,9 @@ LTI Component Settings
        launches, the learners are warned that if they continue, their email
        address will be shared with the LTI provider.
 
-
        By default, this setting is not available in Studio.
-        To make this setting available, a system administrator must enable the
-        setting in the Django administration console.
+       See :ref:`Allow sharing PII to LTI Components` for how to enable
+       (requires system administrator privileges).
 
    * - Request user's username
      - Sends the learner's username to the remote LTI tool. This is the
@@ -186,9 +185,8 @@ LTI Component Settings
        will be shared with the LTI provider.
 
        By default, this setting is not available in Studio.
-
-        To make this setting available in Studio, a system administrator must
-        enable the setting in the Django administration console.
+       See :ref:`Allow sharing PII to LTI Components` for how to enable
+       (requires system administrator privileges).
 
 .. seealso::
 
@@ -202,6 +200,7 @@ LTI Component Settings
 
  :ref:`Enabling and using LTI Advantage features` (how-to)
 
+ :ref:`Allow sharing PII to LTI Components` (how-to)
 
 **Maintenance chart**