Add how to share issues information

Update the docs to explain how we can share issues at present.

Issue: RELENG-2204
Change-Id: Ia58b0cd046b88b7db7278560a395a1b7f1f3e112
Signed-off-by: Andrew Grimberg <agrimberg@linuxfoundation.org>

diff --git a/docs/helpdesk.rst b/docs/helpdesk.rst
index fd2a971..0d6d0bd 100644 (file)
--- a/docs/helpdesk.rst
+++ b/docs/helpdesk.rst
@@ -24,3 +24,35 @@ request, you will receive an automated email notification.
 
 Our response time to routine support requests will vary depending on the nature
 of the request and we will generally take care of issues during US business hours.
+
+Sharing Issues to Others
+========================
+
+A frequently asked question that we receive is how to share issues with other
+people or groups of people. There are presently two ways to share issues:
+
+# You may share issues with other members of an organization you are a member of
+# You may share issues with other organizations that you are a member of
+
+We presently populate organizations based upon the projects in which people open
+issues. If you are not part of one of the project community LFID groups when you
+first log in you may find yourself in one at a later time and will automatically
+join the organization that the group powers.
+
+Once you are a member of an organization your account will default to having new
+issues shared to your organization. This will happen if you are a member of a
+single organization. If you are a member of more than one organization, then you
+will default to creating your issue as private.
+
+During issue triage, if we find that an issue does not contain any private data
+we may share it to the project organization(s) to which it pertains if the
+issue was not automatically created that way.
+
+At present, there is no way to share an issue with arbitrary email addresses.
+We are actively looking into ways in which we may make something like this
+available in the future.
+
+If there is a particular person that needs to be a participant of an issue, the
+support desk staff can add them as a participant as long as they have logged
+into the system at least once. We are unable to add people that have not logged
+in.