Skip to content

Commit

Permalink
same
Browse files Browse the repository at this point in the history
  • Loading branch information
Mikejo5000 committed May 1, 2019
2 parents 26f92d6 + 1706889 commit e935ea4
Show file tree
Hide file tree
Showing 26 changed files with 189 additions and 73 deletions.
13 changes: 13 additions & 0 deletions .github/ISSUE_TEMPLATE/desync_report.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
---
name: Desync detected
about: Please provide information about the desync you encountered to help us resolve the problem
---

**Product and Version** [VS/VSCode]:
**OS Version** [macOS/Windows/Linux]:
**Live Share Extension Version**:
**Target Platform or Language** [e.g. Node.js]:

**What were you doing when you encountered the desync?**

**How often have you encountered desyncs?**
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ Creative Commons Attribution 4.0 License (International): https://creativecommon
</td>
</tr></table>

Many Visual Studio Live Features are available across a number of languages and platforms. [See here to find out what we currently support](https://aka.ms/vsls-docs/platform-support) and note more will be coming in the future. **Visual Studio Live Share is currently in public preview. User experience and features are not final.**
Many Visual Studio Live Features are available across a number of languages and platforms. [See here to find out what we currently support](https://aka.ms/vsls-docs/platform-support) and note more will be coming in the future.

[![Twitter](docs/media/Twitter_Social_Icon_24x24.png)](https://aka.ms/vsls-twitter) [![Mail](docs/media/icon-mail-24x24.png)](mailto:vsls-feedback@microsoft.com)

Expand Down
19 changes: 12 additions & 7 deletions docs/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,15 +22,16 @@ Creative Commons Attribution 4.0 License (International): https://creativecommon
# Frequently Asked Questions

## What is Live Share?
Live Share allows developers to share a codebase and its context so you get instant, bi-directional, collaboration directly from your existing tools (Visual Studio 2017 or Visual Studio Code). With Live Share, your teammate can read, navigate, edit, and debug the project you’ve shared with them, both seamlessly and securely.
Live Share enables you to collaboratively edit and debug with others in real time, regardless what programming languages you're using or app types you're building. It allows you to instantly (and securely) share your current project, and then as needed, share debugging sessions, terminal instances, localhost web apps, and more! Developers that join your sessions recieve all of their editor context from your environment (e.g. language services, debugging), which ensures they can start productively collaborating immediately, without needing to clone any repos or install any SDKs.

## What are the tooling requirements for using Live Share?
The [core capabilities](#what-are-the-core-capabilities-of-live-share) of Live Share are fully supported in the following tools:

* [Visual Studio 2017 (15.6+)](https://visualstudio.microsoft.com/vs/)
* [Visual Studio 2019](https://visualstudio.microsoft.com/vs/)
* [Visual Studio 2017 (15.6+)](https://visualstudio.microsoft.com/vs/older-downloads/)
* [Visual Studio Code](https://code.visualstudio.com/)

During the preview, Live Share will be iterating quickly to respond to user feedback, which may require us to take advantage of features within Visual Studio and Visual Studio Code that are only be available in their respective preview/insider releases. We will indicate which features require more recent versions of VS or VS Code in documentation. For example, local undo/redo support requires Visual Studio 2017 15.7+.
We iterate quickly to respond to user feedback. This requires us to take advantage of features within Visual Studio and Visual Studio Code that are only be available in their respective preview/insider releases. We will indicate which features require more recent versions of VS or VS Code in documentation. For example, local undo/redo support requires Visual Studio 2017 15.7+.

## What are the core capabilities of Live Share?
Live Share enables you to share your codebase with your team members via a secure connection. With Live Share, you are able to collaboratively edit multiple files in a workspace and more importantly debug your application with your teammates. During co-editing your edits are immediately seen by your teammates. During co-debugging you are sharing the same debug session of your application. This means you and your teammates can control the program execution with breakpoints and steps, but you can independently inspect variables, watches, locals, and REPLs (e.g. the Immediate Window in Visual Studio).
Expand All @@ -47,7 +48,7 @@ Live Share's only requirement is that the person sharing and their teammate each
Live Share doesn't transfer all keyboard and mouse inputs. It only communicates the data needed for each collaboration activity to your teammates' machines. For example, when you share your workspace, your folder structure is shared. When you collaboratively edit a file, that file's contents are shared. When you are collaboratively debugging, debug actions (e.g. stepping) and state (e.g. call stack and locals) are shared.

## When will Live Share be released?
Live Share is available now in public preview! We intend to work closely developers testing the preview bits, in order to collect feedback and ensure we can deliver the best experience possible, before opening the service more broadly.
Live Share is now generally available! You can [get started with Live Share](https://aka.ms/vsls-start) today.

## How much will it cost?
We are committed to a substantive free tier of Visual Studio Live Share for developers to use on an ongoing basis. We will be evaluating the introduction of paid tiers with advanced features as we better understand the needs of the community.
Expand Down Expand Up @@ -77,11 +78,15 @@ While this may be desirable for many scenarios, developers often want to collabo

Live Share goes a step further and enables you to share a debug session. This makes it especially useful in enlisting others to help you track down issues that only happen on your machine without altering their development workflow or needing to alter the application design.

## Which languages and platforms will be supported in the preview?
However, our goal is to support the diverse landscape of languages and platforms, to ensure we can enable rich collaboration, regardless of the application type being developed. See the [language and platform support](reference/platform-support.md) article for details on what works today. This is just the start, and we expect to improve this picture moving forward based on feedback.
## Which languages and platforms will be supported?
Our goal is to support the diverse landscape of languages and platforms, to ensure we can enable rich collaboration, regardless of the application type being developed. See the [language and platform support](reference/platform-support.md) article for details on what works today.

## How many developers can join a collaboration session?
We currently support five concurrent guests, in addition to the developer that is sharing ("hosting") their project. Therefore, a collaboration session can have a total of six developers in it at any given time. That said, this is an area we're looking for feedback on, so if you have a use case that requires a higher limit, please [let us know](https://github.com/MicrosoftDocs/live-share/issues/229)!
We currently support 30 concurrent guests, in addition to the developer that is sharing ("hosting") their project. By default we enable up to 5 guests in a session.

To enable increased guest limit:
- **VS Code:** Add "liveshare.increasedGuestLimit":"true" to settings.json.
- **VS:** Set Tools > Options > Live Share > Increased guest limit to "True"

## What is the roadmap?
You can view the set of known issues, and roadmap items [here](https://aka.ms/vsls-issues). If you'd like to see only feature requests rather than all issues, see [here](https://aka.ms/vsls-feature-requests). We encourage you to up-vote existing items, file new feature requests, and log bug reports, in order to help us shape the direction of the product moving forward.
Expand Down
22 changes: 10 additions & 12 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,8 +21,6 @@ Creative Commons Attribution 4.0 License (International): https://creativecommon

# What is Visual Studio Live Share?

> **Note: Visual Studio Live Share is currently in preview. User experience and features are not final.**
Welcome to Visual Studio Live Share! Live Share enables you to collaboratively edit and debug with others in real time, regardless what programming languages you're using or app types you're building. It allows you to instantly and securely share your current project, and then as needed, share debugging sessions, terminal instances, localhost web apps, voice calls, and more!

Additionally, unlike traditional pair programming, Visual Studio Live Share allows developers to work together, while retaining their personal editor preferences (e.g. theme, keybindings), as well as having their own cursor. This allows you to seamlessly transition between following one another, and being able to explore ideas/tasks on your own. In practice, this ability to work together _and_ independently provides a collaboration experience that is potentially more natural for many common use cases.
Expand All @@ -37,8 +35,8 @@ Ready to get going? In this article we'll run you through some concepts and how
Before you begin, you need to be sure you have a version of Visual Studio or Visual Studio Code installed that meets Live Share's core requirements.

- **Visual Studio Code 1.22.0 or higher** - Windows 7, 8.1, or 10, macOS *(Sierra 10.12 and above only)*, 64-bit Linux *(64-bit Ubuntu Desktop 16.04+, Fedora 27+ recommended - [see details](use/vscode.md#installation))*.
- **Visual Studio 2017 15.6 or higher** (any edition) - Windows 7, 8.1, or 10.
- **Visual Studio 2019** (any edition) - Windows 7, 8.1, or 10.
- **Visual Studio 2017 15.6 or higher** (any edition) - Windows 7, 8.1, or 10.

After that, downloading and installing the Visual Studio Live Share extension is a breeze:

Expand All @@ -55,22 +53,22 @@ After that, downloading and installing the Visual Studio Live Share extension is
</td>
</tr>
<tr style="border:none;">
<td width="128px" style="width: 128px; text-align: center; border:none;"><img src="media/vs-ide.svg" width="128px" alt="Visual Studio logo" /></td>
<td width="128px" style="width: 128px; text-align: center; border:none;"><img src="media/vs-ide-2019.svg" width="128px" alt="Visual Studio 2019 logo" /></td>
<td style="border:none;">
<strong>Visual Studio 2017 15.6 or higher</strong><br />
1. Install the latest version of <a href="https://visualstudio.microsoft.com/vs/">Visual Studio 2017</a> (15.6+) on Windows (7, 8.1, or 10).<br/>
<strong>Visual Studio 2019 </strong><br />
1. Install <a href="https://visualstudio.microsoft.com/downloads/">Visual Studio 2019</a>.<br/>
2. Install a <a href="reference/platform-support.md">supported workload</a>. (e.g. ASP.NET, .NET Core, C++, and/or Node.js)<br />
3. Download and install the Visual Studio Live Share extension from the marketplace. <br />
<a href="https://aka.ms/vsls-dl/vs"><img style="padding: 0; spacing: 0;" src="media/download.png" alt="Download button" ></a><br />
3. Visual Studio Live Share is installed by default with these workloads. <br />
</td>
</tr>
<tr style="border:none;">
<td width="128px" style="width: 128px; text-align: center; border:none;"><img src="media/vs-ide-preview.svg" width="128px" alt="Visual Studio Preview logo" /></td>
<td width="128px" style="width: 128px; text-align: center; border:none;"><img src="media/vs-ide-2017.svg" width="128px" alt="Visual Studio 2017 logo" /></td>
<td style="border:none;">
<strong>Visual Studio 2019 </strong><br />
1. Install the latest preview version of <a href="https://aka.ms/vs-preview">Visual Studio 2019</a>.<br/>
<strong>Visual Studio 2017 15.6 or higher</strong><br />
1. Install the latest version of <a href="https://visualstudio.microsoft.com/vs/older-downloads/">Visual Studio 2017</a> (15.6+) on Windows (7, 8.1, or 10).<br/>
2. Install a <a href="reference/platform-support.md">supported workload</a>. (e.g. ASP.NET, .NET Core, C++, Python, and/or Node.js)<br />
3. Visual Studio Live Share is installed by default with these workloads. <br />
3. Download and install the Visual Studio Live Share extension from the marketplace. <br />
<a href="https://aka.ms/vsls-dl/vs"><img style="padding: 0; spacing: 0;" src="media/download.png" alt="Download button" ></a><br />
</td>
</tr>
</table>
Expand Down
Binary file added docs/media/feature-set-vs.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/media/feature-set-vscode.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/media/vs-icon-15x15.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/media/vs-icon-2017-15x15.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/media/vs-icon-2017-24x24.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/media/vs-icon-24x24.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
File renamed without changes
53 changes: 53 additions & 0 deletions docs/media/vs-ide-2019.svg
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/media/vs-join-notification.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/media/vs-join.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/media/vs-share-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/media/vs-sign-in-button.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/media/vs-tools-options.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/media/vscode-icon-15x15.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified docs/media/vscode-icon-24x24.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading

0 comments on commit e935ea4

Please sign in to comment.