Skip to content

Commit

Permalink
Merge pull request microsoft#160 from MicrosoftDocs/repo_sync_working…
Browse files Browse the repository at this point in the history
…_branch

Confirm merge from repo_sync_working_branch to live to sync with https://github.com/microsoftdocs/live-share (branch master)
  • Loading branch information
fubaduba committed Oct 9, 2019
2 parents d3d8ef8 + 320cc5a commit 5006991
Show file tree
Hide file tree
Showing 3 changed files with 12 additions and 33 deletions.
22 changes: 11 additions & 11 deletions docs/reference/presence.md → docs/reference/contacts.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,9 +19,9 @@ All rights reserved.
Creative Commons Attribution 4.0 License (International): https://creativecommons.org/licenses/by/4.0/legalcode
-->

# Contacts in Live Share powered by Presence
# Contacts in Live Share

So you have been using Live Share and notice that sending links via an external application (like chat or email) can get old really fast? We know that if we want to encourage collaboration, there needs to be the least amount of friction possible for you to love it. This is why Live Share now has **contacts** that are infused with **Presence**.
So you have been using Live Share and notice that sending links via an external application (like chat or email) can get old really fast? We know that if we want to encourage collaboration, there needs to be the least amount of friction possible for you to love it. This is why Live Share now has **contacts** that now how **status**.

>Contacts will be automatically enabled for all versions of **Live Share v1.0.950** onwards.
Expand All @@ -43,37 +43,37 @@ All your contacts can be invited directly to a Live Share session from within yo
![DirectInvitationVSCode](https://user-images.githubusercontent.com/51928518/66443914-e59c5d00-e9f5-11e9-957a-b1a92949d660.gif)
<em>A Live Share host (left) directly inviting a peer (right) into a session</em>

## What is Presence?
## How does status for contacts work?
Once developers sign-in with Live Share, **their availability status will be published to their peers.** As a result, you can see that someone on your team is online, and then immediately start collaborating with them, using direct invitation as seen above.
Our Presence service allows you to share you status from within the editor so you can signal you availability to your team, without the need to context switch.
Live Share Presence has 4 statuses currently:
Your status can be set directly from within the editor so you can signal you availability to your team, without the need to context switch.
Live Share contacts have 4 statuses currently:

**1. Available:** Your default status will be `Available` if you have the Live Share extension and are actively using your editor, while not being in a session.

**2. Do not disturb:** Your status is set to `Do not disturb` if you are currently in an active Live Share session and all invitation notifications are suppressed.

**3. Away:** After 5 minutes of inactivity, your status will automatically switch to `Away`.

**4. Offline:** You will be offline once you are away for an extended period of time, or if you choose to [opt-out of presence](##ManagingPresence)
**4. Offline:** You will be offline once you are away for an extended period of time, or if you choose to [opt-out of sharing status](##ManagingPresence)


## Managing Presence <a name="ManagingPresence"> </a>
## Managing contact status<a name="ManagingPresence"> </a>

If you want to opt-out of this feature, you can simply disable the Presence setting by choosing to be `offline`. Once disabled, you'll still be able to see other's status and invite them, but your status won't be published, and others can't directly invite you.
If you want to opt-out of this feature, you can simply disable the status setting by choosing to be `offline`. Once disabled, you'll still be able to see other's status and invite them, but your status won't be published, and others can't directly invite you.
You can choose to be offline by clicking on the status circle which will bring up the following drop-down menu:

![dropdownstatus](../media/vscode-presence-opt-out.png)
<em> Showing drop down of states of Presence</em>

## FAQ's

###### 1. Will I be automatically opting into Presence when I use Live Share v1.0.950 and above?
###### 1. Will I be automatically opting into sharing status when I use Live Share v1.0.950 and above?

The very first time contacts are powered by Presence for your Live Share extension, you will be notified with a toast and an option to opt out of it. After that, you will be automatically share your Presence with your contacts, unless you choose to opt-out as shown above.
The very first time you see contacts you will be notified with a toast and an option to opt out of it sharing your status. After that, you will be automatically share your status with your contacts, unless you choose to opt-out as shown above.

###### 2. Can I add my own contacts?

Currently, our Presence service auto-detects those collaborators who you frequently share code with or work along-side, and does not provide you with the option to add your own contacts.
Currently, our contacts service auto-detects those collaborators who you frequently share code with or work along-side, and does not provide you with the option to add your own contacts.


>Think being able to manually add contacts will be useful? Help us prioritize this by opening a GitHub feature request [here.](https://github.com/MicrosoftDocs/live-share/issues/new?template=feature_request.md)
Expand Down
21 changes: 0 additions & 21 deletions docs/reference/insiders.md
Original file line number Diff line number Diff line change
Expand Up @@ -47,27 +47,6 @@ To create a Reusable Session do the following:
>A Reusable Session link is persistent and lasts for 30 days from its date of creation, or date of last use. This means if you keep using your session at least once every 30 days, you don't have to worry about it expiring. Just save the link in a safe place where you can access it easily!

### **Direct User Invitations**

Currently, both Visual Studio and Visual Studio Code provide a `Contacts` pane, which enables two key functions:

1. Displaying a list of `Suggested Contacts`, which are developers that have contributed to your currently open project within the last 30 days. In practice, these are the folks you're likely to want to collaborate with, and therefore, we suggest them in order to make it easier to get started.

2. Providing the list of `Recent Contacts`, which are developers you've previously collaborated with using Live Share. In practice, most developers frequently collaborate with the same people, and therefore, the recent list enables a more repeatable means of working with your team/classroom/etc.

However, the `Contacts` list currently only allows you to invite recent/suggested contacts via e-mail, which we've learned isn't as efficient as it could be. If you install the latest Live Share update, and enable `Insiders` (as described above), you'll now be able to **invite developers into a collaboration session directly from the IDE**! Note that if you're using Visual Studio Code, you'll need to install the [Insiders Build](https://code.visualstudio.com/insiders/) in order for this feature to work.

![Direct Invitatiosn](https://user-images.githubusercontent.com/116461/59691804-7ece0c00-9198-11e9-94fb-99ec89df91c9.gif)

<em>A Live Share host (left) directly inviting a peer (right) into a session</em>

Once developers sign-in with Live Share, their availability status will be published to their peers. As a result, you can see that someone on your team is online, and then immediately start collaborating with them. They'll get a toast notification that gives them the option to join the session or not. This removes the need to exchange session URLs entirely.

After 5 minutes of inactivity, your status will automatically switch to `Away`, and when you're within a Live Share session, your status will automatically switch to `Do not disturb` (which suprresses invitation toast notifications). After you become active again and/or leave a Live Share session, your status will automatically switch back to `Available`. With this behavior, you don't need to actually manage your Live Share status. It's simply there to enable direct invitations, and communicate to your peers whether you're available for collaboration or not. However, you can always manually set your status if you prefer.

If you want to opt-out of this feature, you can simply disable the `Presence` setting within the Live Share settings in Visual Studio and Visual Studio Code. Once disabled, you'll still be able to see other's status and invite them, but your status won't be published, and others can't directly invite you.



## Become an Insider <a name="BecomeanInsider"> </a>

Expand Down
2 changes: 1 addition & 1 deletion docs/toc.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,7 +29,7 @@
# How-to Guides: Technical Interviews
## [Technical Interviews](use/technical-interviews.md)
# Reference
## [Presence](reference/presence.md)
## [Contacts](reference/presence.md)
## [Security](reference/security.md)
## [Connectivity](reference/connectivity.md)
## [Language Support](reference/platform-support.md)
Expand Down

0 comments on commit 5006991

Please sign in to comment.