Update "JavaScript in Visual Studio 2017"

- Clean up warning formatting
- Remove nonfunctional links
This commit is contained in:
Mine Starks 2019-02-24 17:01:02 -08:00 коммит произвёл GitHub
Родитель c1719d729a
Коммит 229d4eb5a6
Не найден ключ, соответствующий данной подписи
Идентификатор ключа GPG: 4AEE18F83AFDEB23
1 изменённых файлов: 3 добавлений и 18 удалений

Просмотреть файл

@ -10,12 +10,11 @@ The language service underlying the JavaScript experience is all new for Visual
the same engine that provides TypeScript support. This provides for a level of feature support, richness,
and integration that was not possible with the previous JavaScript language service.
> [!WARNING]
> With the new JavaScript language service, while many new features were enabled, some features
> :warning: With the new JavaScript language service, while many new features were enabled, some features
> were also removed. In particular, [IntelliSense extensions](https://msdn.microsoft.com/en-us/library/hh874692.aspx)
> based on the prior language service will not run in the new language service, and the
> [XML documentation comments](https://msdn.microsoft.com/en-us/library/hh524453.aspx) format is no longer recognized.
> See the [Editor IntelliSense](editor/intellisense.md) and [JsDoc](types/jsdoc.md) topics for alternatives.
> [XML documentation comments](https://msdn.microsoft.com/en-us/library/hh524453.aspx) format is no longer recognized.
> See the [JsDoc](types/jsdoc.md) topic for alternatives.
The below provides a high-level overview of various feature areas, with links to more in-depth documentation.
@ -26,8 +25,6 @@ provide an enhanced experience via preconfigured new project templates, rich bui
debuggers, etc. These include ASP.NET & ASP.NET Core projects for web development, Node.js project support,
Cordova for mobile development, and features to support UWP applications.
See the [Projects](projects/index.md) documentation for more information.
## Custom configuration
Detailed configuration information may be provided for JavaScript & TypeScript either directly in the
@ -38,16 +35,12 @@ IntelliSense for, configuration settings for source-map support, settings to con
Since Visual Studio 2017 Update 2, side-by-side versions of the language service are supported. This enables
different projects to target different versions of the language.
See the [Configuration](configuration/index.md) documentation for more information.
## Advanced editing features
The JavaScript and TypeScript languages use the same [Roslyn](https://github.com/dotnet/roslyn)-powered
editor in Visual Studio 2017 that is used for languages such as C#, Visual Basic, etc. This provides a
rich and consistent experience in which to view, edit, and navigate code.
See the [Editor](editor/index.md) documentation for more information.
## Rich type information
One of the key benefits of TypeScript is the volume and quality of "type definitions" for common
@ -57,8 +50,6 @@ Using these type definitions, or type definitions from elsewhere (including your
can provide rich and accurate suggestions, and type checking can catch errors in code. For JavaScript projects,
by default, many of the type definitions needed can be automatically detected and added to the project.
See the [Types](types/index.md) documentation for more information.
## First class Node.js support
Visual Studio 2017 includes a "Node.js" workload, and when installed, project templates for creating
@ -75,8 +66,6 @@ that have had an outsized impact on the community, among them React, Angular, Vu
to name a few. Visual Studio 2017 provides direct support for a number of these, with others support
via easily configured extensions.
See the [Frameworks](frameworks/index.md) documentation for more information.
## Integrated debugging for multiple platforms
Integrated into Visual Studio 2017 is support for debugging several JavaScript engines; among these
@ -87,8 +76,6 @@ These debuggers also have various levels of support for consuming "source-maps",
and mechanism to map from one set of source code to another. For example, from the original TypeScript
code the author wrote, to the minified JavaScript output by WebPack that a debugger consumes.
See the [Debugger](debugging/index.md) documentation for more information.
## Integrated build environment
JavaScript and TypeScript are integrated directly into the Visual Studio build environment, which provides
@ -99,5 +86,3 @@ feature, enabling the output to stay up-to-date as the developer works, without
Beyond the MSBuild support provided by the installation
of Visual Studio, there is also a [TypeScript NuGet package](https://www.nuget.org/packages/Microsoft.TypeScript.MSBuild/)
to provide for cross-platform build.
See the [Build](build/index.md) documentation for more information.