From a2e2b1c3380fb2df220d3eb6f91a66b66aaebf75 Mon Sep 17 00:00:00 2001 From: Rick Anderson Date: Wed, 28 Feb 2018 15:15:49 -1000 Subject: [PATCH 1/2] Landing page - explain full .NET Framework. --- aspnetcore/index.md | 17 +++++++++++++++-- 1 file changed, 15 insertions(+), 2 deletions(-) diff --git a/aspnetcore/index.md b/aspnetcore/index.md index e83ab1095895..f883d007b44e 100644 --- a/aspnetcore/index.md +++ b/aspnetcore/index.md @@ -38,7 +38,7 @@ ASP.NET Core provides the following benefits: * Ability to build and run on Windows, macOS, and Linux. * Open-source and [community-focused](https://live.asp.net/). -ASP.NET Core ships entirely as [NuGet](https://www.nuget.org/) packages. This allows you to optimize your app to include only the necessary NuGet packages. In fact, ASP.NET Core 2.x apps targeting .NET Core only require a [single NuGet package](xref:fundamentals/metapackage). The benefits of a smaller app surface area include tighter security, reduced servicing, and improved performance. +ASP.NET Core ships entirely as [NuGet](https://www.nuget.org/) packages. Using NuGet packages allows you to optimize your app to include only the necessary NuGet packages. In fact, ASP.NET Core 2.x apps targeting .NET Core only require a [single NuGet package](xref:fundamentals/metapackage). The benefits of a smaller app surface area include tighter security, reduced servicing, and improved performance. ## Build web APIs and web UI using ASP.NET Core MVC @@ -54,7 +54,20 @@ ASP.NET Core MVC provides features to build [web APIs](xref:tutorials/index#buil ## Client-side development -ASP.NET Core integrates seamlessly with popular client-side frameworks and libraries, including [Angular](xref:spa/angular), [React](xref:spa/react), and [Bootstrap](xref:client-side/bootstrap). See [Client-side development](xref:client-side/index) for more details. +ASP.NET Core integrates seamlessly with popular client-side frameworks and libraries, including [Angular](xref:spa/angular), [React](xref:spa/react), and [Bootstrap](xref:client-side/bootstrap). For more information, see [Client-side development](xref:client-side/index). + +## ASP.NET Core on the .NET Framework + +ASP.NET Core can target .NET Core or the .NET Framework. ASP.NET Core apps targeting the .NET Framework are cross-platform. There are no plans to remove support for running on the .NET Framework from ASP.NET Core. Generally, ASP.NET Core is made up of .NET Standard 2.0 libraries. Apps written with .NET Standard 2.0 should run anywhere that .NET Standard 2.0 is supported. + +There are several advantages to running on .NET Core, and these advantages increase with each release. Some advantages of .NET Core over .NET Framework include: + +* Cross platform. Runs on MacOS, Linux, and Windows. +* Frequently better performance. +* Side-by-side versioning. +* New APIs. + +We're working hard to close the API gap from .NET Framework to .NET Core. The [Windows Compatibility Pack](https://blogs.msdn.microsoft.com/dotnet/2017/11/16/announcing-the-windows-compatibility-pack-for-net-core/) made thousands of APIs available on .NET Core that were not available in .NET Core 1.x. ## Next steps From 02bc8a13a6589d587ac828db041c765f6c610cfd Mon Sep 17 00:00:00 2001 From: Scott Addie Date: Wed, 28 Feb 2018 21:52:30 -0600 Subject: [PATCH 2/2] .NET Framework target framework patches (#5573) --- aspnetcore/index.md | 21 +++++++++++---------- 1 file changed, 11 insertions(+), 10 deletions(-) diff --git a/aspnetcore/index.md b/aspnetcore/index.md index f883d007b44e..e8220da8fe27 100644 --- a/aspnetcore/index.md +++ b/aspnetcore/index.md @@ -4,7 +4,7 @@ author: rick-anderson description: Provides an introduction to ASP.NET Core. manager: wpickett ms.author: riande -ms.date: 12/12/2017 +ms.date: 02/28/2018 ms.prod: asp.net-core ms.technology: aspnet ms.topic: article @@ -38,7 +38,7 @@ ASP.NET Core provides the following benefits: * Ability to build and run on Windows, macOS, and Linux. * Open-source and [community-focused](https://live.asp.net/). -ASP.NET Core ships entirely as [NuGet](https://www.nuget.org/) packages. Using NuGet packages allows you to optimize your app to include only the necessary NuGet packages. In fact, ASP.NET Core 2.x apps targeting .NET Core only require a [single NuGet package](xref:fundamentals/metapackage). The benefits of a smaller app surface area include tighter security, reduced servicing, and improved performance. +ASP.NET Core ships entirely as [NuGet](https://www.nuget.org/) packages. Using NuGet packages allows you to optimize your app to include only the necessary dependencies. In fact, ASP.NET Core 2.x apps targeting .NET Core only require a [single NuGet package](xref:fundamentals/metapackage). The benefits of a smaller app surface area include tighter security, reduced servicing, and improved performance. ## Build web APIs and web UI using ASP.NET Core MVC @@ -56,18 +56,19 @@ ASP.NET Core MVC provides features to build [web APIs](xref:tutorials/index#buil ASP.NET Core integrates seamlessly with popular client-side frameworks and libraries, including [Angular](xref:spa/angular), [React](xref:spa/react), and [Bootstrap](xref:client-side/bootstrap). For more information, see [Client-side development](xref:client-side/index). -## ASP.NET Core on the .NET Framework +## ASP.NET Core targeting .NET Framework -ASP.NET Core can target .NET Core or the .NET Framework. ASP.NET Core apps targeting the .NET Framework are cross-platform. There are no plans to remove support for running on the .NET Framework from ASP.NET Core. Generally, ASP.NET Core is made up of .NET Standard 2.0 libraries. Apps written with .NET Standard 2.0 should run anywhere that .NET Standard 2.0 is supported. +ASP.NET Core can target .NET Core or .NET Framework. ASP.NET Core apps targeting .NET Framework aren't cross-platform—they run on Windows only. There are no plans to remove support for targeting .NET Framework in ASP.NET Core. Generally, ASP.NET Core is made up of [.NET Standard](/dotnet/standard/net-standard) libraries. Apps written with .NET Standard 2.0 run anywhere that .NET Standard 2.0 is supported. -There are several advantages to running on .NET Core, and these advantages increase with each release. Some advantages of .NET Core over .NET Framework include: +There are several advantages to targeting .NET Core, and these advantages increase with each release. Some advantages of .NET Core over .NET Framework include: -* Cross platform. Runs on MacOS, Linux, and Windows. -* Frequently better performance. -* Side-by-side versioning. -* New APIs. +* Cross-platform. Runs on macOS, Linux, and Windows. +* Improved performance +* Side-by-side versioning +* New APIs +* Open source -We're working hard to close the API gap from .NET Framework to .NET Core. The [Windows Compatibility Pack](https://blogs.msdn.microsoft.com/dotnet/2017/11/16/announcing-the-windows-compatibility-pack-for-net-core/) made thousands of APIs available on .NET Core that were not available in .NET Core 1.x. +We're working hard to close the API gap from .NET Framework to .NET Core. The [Windows Compatibility Pack](/dotnet/core/porting/windows-compat-pack) made thousands of Windows-only APIs available in .NET Core. These APIs weren't available in .NET Core 1.x. ## Next steps