diff --git a/aspnetcore/conceptual-overview/choosing-the-right-dotnet.md b/aspnetcore/conceptual-overview/choosing-the-right-dotnet.md index 45a744dde7..af5a12b7cc 100644 --- a/aspnetcore/conceptual-overview/choosing-the-right-dotnet.md +++ b/aspnetcore/conceptual-overview/choosing-the-right-dotnet.md @@ -1,3 +1,3 @@ --- -redirect_url: /aspnet/core/fundamentals/choosing-the-right-dotnet +redirect_url: https://docs.microsoft.com/dotnet/articles/standard/choosing-core-framework-server --- \ No newline at end of file diff --git a/aspnetcore/fundamentals/choosing-the-right-dotnet.md b/aspnetcore/fundamentals/choosing-the-right-dotnet.md index e94cfe527e..067840a7fb 100644 --- a/aspnetcore/fundamentals/choosing-the-right-dotnet.md +++ b/aspnetcore/fundamentals/choosing-the-right-dotnet.md @@ -1,35 +1,3 @@ --- -title: Choosing the Right .NET For You on the Server | Microsoft Docs -author: rick-anderson -description: -keywords: ASP.NET Core, -ms.author: riande -manager: wpickett -ms.date: 10/14/2016 -ms.topic: article -ms.assetid: 7227b82f-9275-4006-85bc-be55f5e4d39e -ms.technology: aspnet -ms.prod: aspnet-core -uid: fundamentals/choosing-the-right-dotnet +redirect_url: https://docs.microsoft.com/dotnet/articles/standard/choosing-core-framework-server --- -# Choosing the Right .NET For You on the Server - -By [Daniel Roth](https://github.com/danroth27) - -ASP.NET Core is based on the [.NET Core](https://microsoft.com/net/core) project model, which supports building applications that can run cross-platform on Windows, Mac and Linux. When building a .NET Core project you also have a choice of which .NET flavor to target your application at: .NET Framework (CLR), .NET Core (CoreCLR) or [Mono](http://mono-project.com). Which .NET flavor should you choose? Let's look at the pros and cons of each one. - -## .NET Framework - -The .NET Framework is the most well known and mature of the three options. The .NET Framework is a mature and fully featured framework that ships with Windows. The .NET Framework ecosystem is well established and has been around for well over a decade. The .NET Framework is production ready today and provides the highest level of compatibility for your existing applications and libraries. - -The .NET Framework runs on Windows only. It is also a monolithic component with a large API surface area and a slower release cycle. While the code for the .NET Framework is [available for reference](http://referencesource.microsoft.com/) it is not an active open source project. - -## .NET Core - -.NET Core is a modular runtime and library implementation that includes a subset of the .NET Framework. .NET Core is supported on Windows, Mac and Linux. .NET Core consists of a set of libraries, called "CoreFX", and a small, optimized runtime, called "CoreCLR". .NET Core is open-source, so you can follow progress on the project and contribute to it on [GitHub](https://github.com/dotnet). - -The CoreCLR runtime (Microsoft.CoreCLR) and CoreFX libraries are distributed via [NuGet](https://nuget.org). Because .NET Core has been built as a componentized set of libraries you can limit the API surface area your application uses to just the pieces you need. You can also run .NET Core based applications on much more constrained environments (ex. [ASP.NET Core on Nano Server](../tutorials/nano-server.md)). - -The API factoring in .NET Core was updated to enable better componentization. This means that existing libraries built for the .NET Framework generally need to be recompiled to run on .NET Core. The .NET Core ecosystem is relatively new, but it is rapidly growing with the support of popular .NET packages like JSON.NET, AutoFac, xUnit.net and many others. - -Developing on .NET Core allows you to target a single consistent platform that can run on multiple platforms. diff --git a/aspnetcore/fundamentals/index.md b/aspnetcore/fundamentals/index.md index 7f85d02648..f0a1f14e0e 100644 --- a/aspnetcore/fundamentals/index.md +++ b/aspnetcore/fundamentals/index.md @@ -95,13 +95,16 @@ Environments, like "Development" and "Production", are a first-class notion in A For more information, see [Working with Multiple Environments](environments.md). +## .NET Core vs. .NET Framework runtime + +An ASP.NET Core app can use the .NET Core or .NET Framework runtime. For more information, see [Choosing between .NET Core and .NET Framework](https://docs.microsoft.com/dotnet/articles/standard/choosing-core-framework-server). + ## Additional information -See also the following resources: +See also the following topics: - [Logging](logging.md) - [Error Handling](error-handling.md) - [Globalization and localization](localization.md) - [File Providers](file-providers.md) - [Managing Application State](app-state.md) -- [Choosing the Right .NET For You on the Server](choosing-the-right-dotnet.md) \ No newline at end of file diff --git a/aspnetcore/getting-started.md b/aspnetcore/getting-started.md index 8663b5dc07..16fe827067 100644 --- a/aspnetcore/getting-started.md +++ b/aspnetcore/getting-started.md @@ -1,5 +1,5 @@ --- -title: Getting Started | Microsoft Docs +title: Getting Started with ASP.NET Core | Microsoft Docs author: rick-anderson description: keywords: ASP.NET Core, @@ -12,7 +12,7 @@ ms.technology: aspnet ms.prod: aspnet-core uid: getting-started --- -# Getting Started +# Getting Started with ASP.NET Core 1. Install [.NET Core](https://microsoft.com/net/core) @@ -40,6 +40,8 @@ uid: getting-started ## Next steps -* [Building your first ASP.NET Core MVC app with Visual Studio](tutorials/first-mvc-app/index.md) -* [Your First ASP.NET Core Application on a Mac Using Visual Studio Code](tutorials/your-first-mac-aspnet.md) -* [Building Your First Web API with ASP.NET Core MVC and Visual Studio](tutorials/first-web-api.md) +For more getting-started tutorials, see [ASP.NET Core Tutorials](tutorials/index.md) + +For an introduction to ASP.NET Core concepts and architecture, see [ASP.NET Core Introduction](index.md) and [ASP.NET Core Fundamentals](fundamentals/index.md). + +An ASP.NET Core app can use the .NET Core or .NET Framework runtime. For more information, see [Choosing between .NET Core and .NET Framework](https://docs.microsoft.com/dotnet/articles/standard/choosing-core-framework-server). diff --git a/aspnetcore/index.md b/aspnetcore/index.md index 7bd38bc095..550486fa70 100644 --- a/aspnetcore/index.md +++ b/aspnetcore/index.md @@ -16,7 +16,7 @@ uid: index By [Daniel Roth](https://github.com/danroth27), [Rick Anderson](https://twitter.com/RickAndMSFT), and [Shaun Luttin](https://twitter.com/dicshaunary) -ASP.NET Core is a significant redesign of ASP.NET. This topic introduces the new concepts in ASP.NET Core and explains how they help you develop modern web apps. +ASP.NET Core is a significant redesign of ASP.NET. This topic introduces the new concepts in ASP.NET Core and explains how they help you develop modern web apps. ## What is ASP.NET Core? @@ -74,10 +74,9 @@ ASP.NET Core is designed to integrate seamlessly with a variety of client-side f ## Next steps -* [Building your first ASP.NET Core MVC app with Visual Studio](tutorials/first-mvc-app/index.md) +For getting-started tutorials, see [ASP.NET Core Tutorials](tutorials/index.md) -* [Your First ASP.NET Core Application on a Mac Using Visual Studio Code](tutorials/your-first-mac-aspnet.md) +For in-depth introduction to ASP.NET Core concepts and architecture, see [ASP.NET Core Fundamentals](fundamentals/index.md). -* [Building Your First Web API with ASP.NET Core MVC and Visual Studio](tutorials/first-web-api.md) +An ASP.NET Core app can use the .NET Core or .NET Framework runtime. For more information, see [Choosing between .NET Core and .NET Framework](https://docs.microsoft.com/dotnet/articles/standard/choosing-core-framework-server). -* [Fundamentals](fundamentals/index.md) diff --git a/aspnetcore/toc.md b/aspnetcore/toc.md index 172c657495..ea59c44ce4 100644 --- a/aspnetcore/toc.md +++ b/aspnetcore/toc.md @@ -21,7 +21,7 @@ ### [WebListener](fundamentals/servers/weblistener.md) ## [Request Features](fundamentals/request-features.md) ## [Open Web Interface for .NET (OWIN)](fundamentals/owin.md) -## [Choosing the Right .NET For You on the Server](fundamentals/choosing-the-right-dotnet.md) +## [Choosing between .NET Core and .NET Framework runtime](https://docs.microsoft.com/dotnet/articles/standard/choosing-core-framework-server) # [MVC](mvc/toc.md) # [Testing](testing/toc.md) # [Working with Data](data/toc.md)