diff --git a/content/codespaces/developing-in-a-codespace/index.md b/content/codespaces/developing-in-a-codespace/index.md index 6f605d5d72e8..594eda098429 100644 --- a/content/codespaces/developing-in-a-codespace/index.md +++ b/content/codespaces/developing-in-a-codespace/index.md @@ -12,7 +12,6 @@ children: - /creating-a-codespace-from-a-template - /deleting-a-codespace - /opening-an-existing-codespace - - /working-collaboratively-in-a-codespace - /using-source-control-in-your-codespace - /using-github-codespaces-for-pull-requests - /stopping-and-starting-a-codespace diff --git a/content/codespaces/developing-in-a-codespace/working-collaboratively-in-a-codespace.md b/content/codespaces/developing-in-a-codespace/working-collaboratively-in-a-codespace.md deleted file mode 100644 index 5dc908a2cda3..000000000000 --- a/content/codespaces/developing-in-a-codespace/working-collaboratively-in-a-codespace.md +++ /dev/null @@ -1,64 +0,0 @@ ---- -title: Working collaboratively in a codespace -shortTitle: Work collaboratively -intro: 'You can work collaboratively with other people in a codespace by using {% data variables.product.prodname_vs %} Live Share.' -versions: - fpt: '*' - ghec: '*' -type: how_to -topics: - - Codespaces - - Developer -redirect_from: - - /codespaces/developing-in-codespaces/working-collaboratively-in-a-codespace ---- - -{% data variables.product.prodname_vs %} Live Share lets you collaboratively edit and debug with others in real time, within a codespace. You can securely share your current codespace, or access a codespace created by someone else. - -You can start a Live Share session either within the {% data variables.product.prodname_vscode_shortname %} web client in your browser, or within the {% data variables.product.prodname_vscode_shortname %} desktop application. - -For more information about Live Share, see "[What is {% data variables.product.prodname_vs %} Live Share?](https://learn.microsoft.com/en-us/visualstudio/liveshare/)" in the {% data variables.product.prodname_vs %} documentation. - -## Sharing your codespace with someone else - -1. In the Activity Bar, click the Extensions icon. -1. In the search box, type `Live Share`. - - ![Screenshot of the "Extensions: Marketplace" side bar with "live share" entered in the search box. "Live Share" is the first in the list of extensions.](/assets/images/help/codespaces/live-share-search-extensions.png) - -1. If the **Install** button is displayed beside the extension, click it to install the extension in the codespace. -1. If the extension is shown grayed out in the list, right-click it and click **Enable**. - - ![Screenshot of the "Enable" right-click menu option.](/assets/images/help/codespaces/live-share-enable-rightclick.png) - -1. In the Activity Bar, click the Live Share icon. - - ![Screenshot of the Activity Bar. The Live Share icon (an arrow above a circle) is highlighted with a dark orange outline.](/assets/images/help/codespaces/live-share-click-icon.png) - -1. Click **Share**. - - A "toast" notification message is displayed at the bottom right corner of {% data variables.product.prodname_vscode_shortname %}, telling you that a link to your codespace has been copied to the clipboard. You can click **Make read-only** if you want to prevent guests from making changes to the files you share with them. - - ![Screenshot of a popup message: "Invitation link copied to clipboard!" There are three buttons: "Make read-only," "More info," and "Copy again."](/assets/images/help/codespaces/live-share-link-copied-clipboard.png) - -1. Send the link in your clipboard to anyone you want to join you in your Live Share session. - - {% note %} - - **Important**: Given the level of access Live Share sessions can provide to guests, you should only share with people you trust, and you should think through the implications of what you are sharing. For more information, see "[Security features of Live Share](https://learn.microsoft.com/en-us/visualstudio/liveshare/reference/security)" in the {% data variables.product.prodname_vs %} documentation. - - {% endnote %} - -## Stopping a Live Share session - -To stop sharing your codespace, click the stop icon in the Live Share panel. - -![Screenshot of the stop icon to the right of "Session Details" in the "Live Share" side bar. The icon is a circle with a diagonal line through it.](/assets/images/help/codespaces/live-share-stop-collaboration.png) - -If you, as the person who started the Live Share session, close the codespace the sharing session ends, even if the codespace remains active on the remote host. - -The idle timeout, which automatically stops a codespace after a period of inactivity, only applies to the person who started the codespace. It does not apply to people who are working on the codespace via Live Share. The codespace may therefore time out while collaborators are using the codespace if the person who started the codespace remains inactive for the configured period of time. For more information, see "[AUTOTITLE](/codespaces/setting-your-user-preferences/setting-your-timeout-period-for-github-codespaces)." - -## Working collaboratively in someone else's codespace - -If you want to work with someone within a codespace they've created, ask them to set up a Live Share session and send you a link, as described above. diff --git a/content/codespaces/guides.md b/content/codespaces/guides.md index 6f849a29ef0a..61ce54985382 100644 --- a/content/codespaces/guides.md +++ b/content/codespaces/guides.md @@ -30,7 +30,6 @@ includeGuides: - /codespaces/developing-in-a-codespace/forwarding-ports-in-your-codespace - /codespaces/developing-in-a-codespace/opening-an-existing-codespace - /codespaces/developing-in-a-codespace/stopping-and-starting-a-codespace - - /codespaces/developing-in-a-codespace/working-collaboratively-in-a-codespace - /codespaces/developing-in-a-codespace/using-github-codespaces-in-visual-studio-code - /codespaces/developing-in-a-codespace/using-github-codespaces-in-your-jetbrains-ide - /codespaces/developing-in-a-codespace/using-github-codespaces-with-github-cli diff --git a/content/codespaces/overview.md b/content/codespaces/overview.md index 8e8707b05b60..f8d35bc70697 100644 --- a/content/codespaces/overview.md +++ b/content/codespaces/overview.md @@ -38,7 +38,7 @@ Reasons for choosing to work in a codespace include: * **Work anywhere** - All you need is a web browser. You can work in a codespace on your own computer, on a friend's laptop, or on a tablet. Open your codespace and pick up from where you left off on a different device. * **Choose your editor** - Work in the browser in the {% data variables.product.prodname_vscode_shortname %} web client, or choose from a selection of desktop-based applications. * **Work on multiple projects** - You can use multiple codespaces to work on separate projects, or on different branches of the same repository, compartmentalizing your work to avoid changes made for one piece of work accidentally affecting something else you're working on. -* **Pair program with a teammate** - If you work on a codespace in {% data variables.product.prodname_vscode_shortname %}, you can use Live Share to work collaboratively with other people on your team. For more information, see "[AUTOTITLE](/codespaces/developing-in-a-codespace/working-collaboratively-in-a-codespace)." +* **Pair program with a teammate** - If you work on a codespace in {% data variables.product.prodname_vscode_shortname %}, you can use Live Share to work collaboratively with other people on your team. * **Publish your web app from a codespace** - Forward a port from your codespace and then share the URL, to allow teammates to try out the changes you've made to the application before you submit those changes in a pull request. * **Try out a framework** - {% data variables.product.prodname_github_codespaces %} reduces the setup time when you want to learn a new framework. Just create a codespace from one of the [quickstart templates](https://github.com/codespaces/templates).