diff --git a/docs/intellicode-visual-studio-code-completions.md b/docs/intellicode-visual-studio-code-completions.md new file mode 100644 index 0000000..8fa558c --- /dev/null +++ b/docs/intellicode-visual-studio-code-completions.md @@ -0,0 +1,59 @@ +--- +title: VS Code Completions Preview +description: Read an overview of IntelliCode for Visual Studio Code. The IntelliCode extension provides AI-assisted IntelliSense for Python, Java, TypeScript, and JavaScript. +ms.custom: SEO-VS-2020 +ms.date: 04/19/2022 +ms.prod: visual-studio-family +ms.technology: intellicode +ms.topic: conceptual +author: aayim +ms.author: aayim +manager: andster +--- + +# IntelliCode Completions Preview for Visual Studio Code + +The [IntelliCode Completions extension for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=VisualStudioExptTeam.vscodeintellicode-completions) is an experimental extension which predicts up to a whole line of code based on your current code context. + +![IntelliCode Completions for Python in Visual Studio Code](../images/wlc.gif) + +This extension may contain unstable, experimental code. The IntelliCode team is focused on iterating rapidly and new functionality will be added. + +## How to use +![IntelliCode Completions interpreting IntelliSense completion list selection in Visual Studio Code](../images/intellisenseSelection.gif) + +Completions will appear after your cursor as you type, with a faded color. When the IntelliSense list is open, its selection is used to inform the whole-line autocompletion. + +At any time you can accept the suggestion by pressing the tab key (you will need to press it twice if the IntelliSense list is visible). If you don't want to accept the suggestion, you can just keep on typing or press ESC. + +### Snippet Completion + +![Accepting a grey text completion with empty string automatically moves the cursor to the empty string](media/vsc-wlc-snippetcompletion.gif) + +If the whole-line autocompletion includes empty strings: + +1. The cursor will automatically move to the first empty string upon accepting the prediction with the TAB key. +2. If further empty strings exist within the prediction, pressing the TAB key again will automatically move the cursor to the next empty string. + +### Enabling JavaScript/TypeScript Support + +To enable experimental support for JavaScript and TypeScript, search for `intellicodeCompletions.language` in the Settings menu. + +## Installation + +The extension can be aquired at the following link: [IntelliCode Completions extension for VS Code](https://marketplace.visualstudio.com/items?itemName=VisualStudioExptTeam.vscodeintellicode-completions) + +The extension is supported by Visual Studio Code November 2021 Release 1.63 or later. + +## Provide feedback + +If you encounter a problem, you can browse [existing issues](https://github.com/MicrosoftDocs/intellicode/issues) and upvote them using a 👍 "thumbs up" reaction. If you don't see your particular problem, we'd love to hear from you. Include any **Output** window log entries from Visual Studio IntelliCode, Python, Java, JavaScript, or TypeScript with the bug. + +## See also + +- [IntelliCode for Visual Studio](intellicode-visual-studio.md) +- [IntelliCode general FAQ](faq.yml) + + + + diff --git a/docs/intellicode-visual-studio-code.md b/docs/intellicode-visual-studio-code.md index 15fc7c4..7e3fb7e 100644 --- a/docs/intellicode-visual-studio-code.md +++ b/docs/intellicode-visual-studio-code.md @@ -16,24 +16,24 @@ The [IntelliCode extension for Visual Studio Code](https://marketplace.visualstu ![IntelliCode for Python in Visual Studio Code](media/python-intellicode.gif) -## Supported languages - -The supported languages for AI-assisted IntelliSense completions are: +IntelliCode provides AI-assisted IntelliSense completions for the following languages: - Java - JavaScript and TypeScript - Python - SQL -## Prerequisites -To install the extension, you need Visual Studio Code October 2018 Release 1.29 or later. +### Prerequisites + +The extension is supported by Visual Studio Code June 2021 Release 1.58 or later. + +AI-assisted IntelliSense for Java requires Java 8 Update 151 or higher. -To get AI-assisted IntelliSense for Java, you need Java 8 Update 151 or higher. (If you have a previous Java 8 version, you'll see the error **java.security.InvalidKeyException: Illegal key size**, and IntelliCode AI-assisted IntelliSense recommendations won't work.) ## Troubleshoot -This section provides some troubleshooting tips for common problems. +This section provides some troubleshooting tips for common problems with IntelliCode. ### No completion lists @@ -67,7 +67,7 @@ If you see IntelliSense completion lists, but none of the completion items are s As a first step, try updating to Visual Studio Code 1.30 or later, and [turning on network proxy support](https://code.visualstudio.com/updates/v1_30#_network-proxy-support-for-extensions) . If turning on network proxy support doesn't work for you, check the corresponding [github issue](https://github.com/MicrosoftDocs/intellicode/issues/4) and let us know more. - +- If you're a Java user experiencing the error message **java.security.InvalidKeyException: Illegal key size**, check to make sure you're using Java 8 Update 151 or later. - Is there an actionable message that helps? If you're still facing a problem, look through the [existing issues](https://github.com/MicrosoftDocs/intellicode/issues) or open a new one. @@ -75,7 +75,6 @@ If you're still facing a problem, look through the [existing issues](https://git ## Provide feedback If you encounter a problem, you can browse [existing issues](https://github.com/MicrosoftDocs/intellicode/issues) and upvote them using a 👍 "thumbs up" reaction. If you don't see your particular problem, click the **Send feedback about** > **This product** button at the bottom of this page to create a new issue. Include any **Output** window log entries from Visual Studio IntelliCode, Python, Java, JavaScript, TypeScript, or SQL with the bug. - ## See also - [IntelliCode for Visual Studio](intellicode-visual-studio.md) diff --git a/docs/media/vsc-wlc-snippetcompletion.gif b/docs/media/vsc-wlc-snippetcompletion.gif new file mode 100644 index 0000000..4fe9b6f Binary files /dev/null and b/docs/media/vsc-wlc-snippetcompletion.gif differ diff --git a/docs/overview.md b/docs/overview.md index 6fc1a77..7006ee1 100644 --- a/docs/overview.md +++ b/docs/overview.md @@ -21,7 +21,7 @@ For more information and to sign up for news and updates, see [Visual Studio Int Before you begin, ensure you have a version of Visual Studio or Visual Studio Code that supports IntelliCode. The minimum requirements are: -- Visual Studio Code October 2018 Release 1.29 or later +- Visual Studio Code June 2021 Release 1.58 or later - Visual Studio 2019 (Release 16.4 or higher, any edition) The following table contains details about how to obtain IntelliCode for your development environment: @@ -40,7 +40,9 @@ IntelliCode provides AI-assisted IntelliSense in both Visual Studio and Visual S The completion list suggests the most likely correct API for a developer to use rather than presenting a simple alphabetical list of members. To provide this dynamic list, IntelliCode uses the developer's current code context as well as patterns based on thousands of highly rated, open-source projects on GitHub. The results form a model that predicts the most likely and most relevant API calls. ![C# Whole line completions in Visual Studio](media/intellicode-vs-wlc-small.png) -C# developers in Visual Studio 2022 and higher also benefit from [Whole line completions](visual-studio-whole-line-completions.md) which predict the next chunk of your code based on your current code so far, and present it as an inline prediction. +C# developers in Visual Studio 2022 and higher also benefit from [whole-line autocompletions](visual-studio-whole-line-completions.md) which predict the next chunk of your code based on your current code so far, and present it as an inline prediction. + +Python, JavaScript, and TypeScript developers using Visual Studio Code Release 1.63 or higher can also benefit from whole-line autocompletions through a [new preview extension for Visual Studio Code](intellicode-visual-studio-code-completions.md). ## Visual Studio features Check the [overview of IntelliCode for Visual Studio](intellicode-visual-studio.md) for full details of the additional features supported for Visual Studio users, such as [IntelliCode suggestions](intellicode-suggestions.md).