diff --git a/_includes/gs/docker_gs.html b/_includes/gs/docker_gs.html index f197f58d..6d5143cd 100644 --- a/_includes/gs/docker_gs.html +++ b/_includes/gs/docker_gs.html @@ -3,7 +3,7 @@
1

Install Docker

-

Before you can try out the .NET Core Docker base images, you should install Docker. Refer to Mac or Windows or Linux getting started instructions for Docker.

+

Before you can try out the .NET Core Docker base images, you should install Docker. Refer to Mac, Windows or Linux getting started instructions for Docker.

2
diff --git a/_includes/gs/linux_gs.html b/_includes/gs/linux_gs.html index 1912e9ac..5355305d 100644 --- a/_includes/gs/linux_gs.html +++ b/_includes/gs/linux_gs.html @@ -4,7 +4,7 @@
1

Add the new apt-get feed

In order to install .NET Core on Ubuntu, we need to first set up the apt-get feed that hosts the package we need.

-

Note: as of now, the below instructions work on Ubuntu 14.04 and derivatives. New versions are coming up soon! Also, please be aware that this feed is our development feed. As we stabilize we will change feeds where deb packages are stored.

+

Note: as of now, the below instructions work on Ubuntu 14.04 and derivatives. New versions are coming up soon! Also, please be aware that this feed is our development feed. As we stabilize we will change feeds where dev packages are stored.

@@ -18,7 +18,7 @@

Add the new apt-get feed

2

Install .NET Core

-

Installing .NET Core is a simple thing on Ubuntu. The below will install the package and all of its dependencies.

+

Installing .NET Core is a simple thing on Ubuntu. The below will install the package and all of its dependencies:

diff --git a/_includes/gs/macosx_gs.html b/_includes/gs/macosx_gs.html index f28a5386..1e20fd43 100644 --- a/_includes/gs/macosx_gs.html +++ b/_includes/gs/macosx_gs.html @@ -22,7 +22,7 @@

Initialize some code

3

Run the app

-

The first command will restore the packages specified in the project.json file, and the second command will run the actuall sample:

+

The first command will restore the packages specified in the project.json file, and the second command will run the actual sample:

diff --git a/_includes/hero.html b/_includes/hero.html index be730638..cba38f26 100644 --- a/_includes/hero.html +++ b/_includes/hero.html @@ -2,7 +2,7 @@

.NET Core

-

A general purpose managed framework

+

A general-purpose managed framework

Getting started About .NET Core diff --git a/_includes/value_props.html b/_includes/value_props.html index 7404115e..af5f0208 100644 --- a/_includes/value_props.html +++ b/_includes/value_props.html @@ -4,17 +4,17 @@

Modular

-

.NET Core is a set of runtime, library and compiler components. Microsoft uses these components in various configurations for device and cloud workloads. You can do the same for your app or service.

+

.NET Core is a set of runtime, library, and compiler components. Microsoft uses these components in various configurations for device and cloud workloads. You can do the same for your app or service.

Managed

-

Managed runtimes make code easy to write and guarantee safe execution. .NET Core manages memory with a garbage collector, compiles your code with a JIT compiler or ahead of time with .NET Native.

+

Managed runtimes make code easy to write and guarantee safe execution. .NET Core manages memory with a garbage collector, and compiles your code with a JIT compiler or ahead of time with .NET Native.

Cross-platform

-

You can create .NET Core apps that run on multiple OSes and CPUs. .NET Core runs on Windows. Ports are in progress for Linux, OS X and FreeBSD, as is integration with the LLVM compiler.

+

You can create .NET Core apps that run on multiple Operating Systems and CPUs. .NET Core runs on Windows. Ports are in progress for Linux, OS X and FreeBSD, as is integration with the LLVM compiler.

diff --git a/about/index.md b/about/index.md index fdfacf1f..97a456f0 100644 --- a/about/index.md +++ b/about/index.md @@ -3,14 +3,14 @@ layout: main title: About .NET Core --- ## About .NET -.NET is a general purpose development platform. It has several key features that are attractive to many developers, including automatic memory management and modern programming languages, that make it easier to efficiently build high-quality apps. Multiple implementations of .NET are available, based on open [.NET Standards](https://github.com/dotnet/coreclr/blob/master/Documentation/project-docs/dotnet-standards.md) that specify the fundamentals of the platform. +.NET is a general-purpose development platform. It has several key features that are attractive to many developers, including automatic memory management and modern programming languages, which make it easier to efficiently build high-quality apps. Multiple implementations of .NET are available, based on open [.NET Standards](https://github.com/dotnet/coreclr/blob/master/Documentation/project-docs/dotnet-standards.md) that specify the fundamentals of the platform. You can read more about .NET in the [.NET Primer](/docs/concepts/primer.html). ## About .NET Core .NET Core is a cross-platform implementation of .NET that is primarily being driven by ASP.NET 5 workloads, but also by the need and desire to have a modern runtime that is modular and whose features and libraries can be cherry picked based on the application's needs. You can learn more about .NET Core and how and where you can use it in the [CoreCLR is open source](http://blogs.msdn.com/b/dotnet/archive/2015/02/03/coreclr-is-now-open-source.aspx) blog post. -.NET Core consists of the [CoreCLR](https://github.com/dotnet/coreclr) runtime and the [CoreFX](https://github.com/dotnet/corefx) framework libraries. A set of cross-platform tooling can be found in the [.NET CLI](https://github.com/dotnet/cli/). The [Roslyn compiler](https://github.com/dotnet/roslyn) and [LLILC compiler](https://github.com/dotnet/llilc) are sibling projects that support .NET Core. These projects are active on GitHub. You can participate by creating issues or collaborate on development. The main goal of the project is to create a modular, performant and cross-platform execution environment for modern applications. +.NET Core consists of the [CoreCLR](https://github.com/dotnet/coreclr) runtime and the [CoreFX](https://github.com/dotnet/corefx) framework libraries. A set of cross-platform tooling can be found in the [.NET CLI](https://github.com/dotnet/cli/). The [Roslyn compiler](https://github.com/dotnet/roslyn) and [LLILC compiler](https://github.com/dotnet/llilc) are sibling projects that support .NET Core. These projects are active on GitHub where you can participate by creating issues or collaborating on development. The main goal of the project is to create a modular, performant, and cross-platform execution environment for modern applications. ## Further reading on .NET Core -If you want to understand more details about .NET Core and its ecosystem, you can read the [deeper understanding](overview.html) write up that explains the entire stack, what the moving pieces are and so forth. You can also check out the [support](/support/) page to see a great list of resources where members of our team and of wider community can help you. +If you want to understand more details about .NET Core and its ecosystem, you can read the [deeper understanding](overview.html) write up that explains the entire stack, what the moving pieces are, etc. You can also visit the [support](/support/) page to see a great list of resources where members of our team and of wider community can help you. diff --git a/docs/concepts/editions-overview.html b/docs/concepts/editions-overview.html index 7acd2b22..02aa522e 100644 --- a/docs/concepts/editions-overview.html +++ b/docs/concepts/editions-overview.html @@ -1,4 +1,4 @@ - + @@ -72,7 +72,7 @@

Overview of .NET Implementations

The .NET Platform is described by a set of open standards that define its architecture and semantic behavior. The ECMA 335 standard, in particular, must be implemented to be considered a compliant .NET runtime. There are multiple implementations of these standards, provided by Microsoft and other companies, some of which are described below.

The architecture defined in ECMA 335 enables CPU- and OS-agnostic programming models, resulting in portable .NET binaries. A given .NET implementation may support multiple operating systems and CPUs and make it possible to run unmodified libraries and apps on multiple of those configurations. Portable Class Libraries and the .NET Platform Standard define portable API sets that are supported by multiple .NET implementations, making it possible to run unmodified libraries across multiple .NET implementations.

.NET Core

-

.NET Core is a general purpose and cross-platform implementation of the .NET Platform. ASP.NET Core is the primary workload that runs on .NET Core.

+

.NET Core is a general-purpose and cross-platform implementation of the .NET Platform. ASP.NET Core is the primary workload that runs on .NET Core.

The following are the main characteristics of .NET Core:

Cross-platform - .NET Core currently supports three main operating systems: Linux, Windows and OS X. There are other OS ports in progress such as FreeBSD and Alpine. .NET Core libraries can run unmodified across supported OSes. The apps must be re-compiled per environment, given that apps use a native host. Users select the .NET Core supported environment that works best for their situation.

Open Source - .NET Core is available on GitHub, licensed with the MIT and Apache 2 licenses (licensing is per component). It also makes use of a significant set of open source industry dependencies (see release notes).

diff --git a/docs/concepts/primer.html b/docs/concepts/primer.html index a0ba5192..67871ebb 100644 --- a/docs/concepts/primer.html +++ b/docs/concepts/primer.html @@ -1,4 +1,4 @@ - + @@ -70,7 +70,7 @@

.NET Primer

By Rich Lander, Zlatko Knezevic

-

.NET is a general purpose development platform. It can be used for any kind of app type or workload where general purpose solutions are used. It has several key features that are attractive to many developers, including automatic memory management and modern programming languages, that make it easier to efficiently build high-quality apps. .NET enables a high-level programming environment with many convenience features, while providing low-level access to native memory and APIs.

+

.NET is a general-purpose development platform. It can be used for any kind of app type or workload where general purpose solutions are used. It has several key features that are attractive to many developers, including automatic memory management and modern programming languages, that make it easier to efficiently build high-quality apps. .NET enables a high-level programming environment with many convenience features, while providing low-level access to native memory and APIs.

Multiple implementations of .NET are available, based on open .NET Standards that specify the fundamentals of the platform. They are separately optimized for different app types (e.g. desktop, mobile, gaming, cloud) and support many chips (e.g. x86/x64, ARM) and operating systems (e.g. Windows, Linux, iOS, Android, OS X). Open source is also an important part of the .NET ecosystem, with multiple .NET implementations and many libraries available under OSI-approved licenses.

You can take a look at the Overview of .NET implementations document to figure out all of the different editions of the .NET Framework that are available, both Microsoft’s and others.

Key .NET Concepts

diff --git a/docs/index.html b/docs/index.html index 7d655b60..a57b6d65 100644 --- a/docs/index.html +++ b/docs/index.html @@ -1,4 +1,4 @@ - + @@ -69,7 +69,7 @@ Improve this Doc

Getting started

-

In this docset, you will find tutorials that will teach you how to get started with .NET Core. You can also find the API reference documentation.

+

In this website, you will find tutorials that will teach you how to get started with .NET Core. You can also find the API reference documentation.

What kinds of applications do you want to build?

  • Console application
    • diff --git a/docs/libraries/libraries-with-cli.html b/docs/libraries/libraries-with-cli.html index e77f7569..cbf721a6 100644 --- a/docs/libraries/libraries-with-cli.html +++ b/docs/libraries/libraries-with-cli.html @@ -1,13 +1,13 @@ - + - Writing Libraries with Cross Platform Tools | CoreCLR site + Writing Libraries with Cross-Platform Tools | CoreCLR site - + @@ -67,7 +67,7 @@
    Improve this Doc -

    Writing Libraries with Cross Platform Tools

    +

    Writing Libraries with Cross-Platform Tools

    By Phillip Carter

    Some details are subject to change as the toolchain evolves.

    diff --git a/docs/libraries/overview.html b/docs/libraries/overview.html index 2be31435..a38adc77 100644 --- a/docs/libraries/overview.html +++ b/docs/libraries/overview.html @@ -1,4 +1,4 @@ - + @@ -71,7 +71,7 @@

    Overview

    Writing libraries on .NET Core can be done in two different ways. You can use a command line interface (CLI) to build, test, and run you code on Linux, OS X, or Windows. You can also get a full IDE experience on Windows with Visual Studio.

    diff --git a/docs/toc.html b/docs/toc.html index f7457668..1b50a2e3 100644 --- a/docs/toc.html +++ b/docs/toc.html @@ -1,4 +1,4 @@ - + @@ -179,7 +179,7 @@ Overview
  • - Creating a class library with Cross Platform Tools + Creating a class library with Cross Platform Tools
  • Creating a class library in Visual Studio @@ -396,7 +396,7 @@ Overview
  • - Creating a class library with Cross Platform Tools + Creating a class library with Cross Platform Tools
  • Creating a class library in Visual Studio @@ -500,4 +500,4 @@ - \ No newline at end of file + diff --git a/porting/index.html b/porting/index.html index 37e10aea..00b2e30e 100644 --- a/porting/index.html +++ b/porting/index.html @@ -22,7 +22,7 @@

    Porting to .NET Core

    Tools to help you port

    In this section you will find tools that can help you with porting your code to .NET Core.

    ApiPort

    -

    ApiPort is a tool that analyzes your assemblies and gives you a report on what APIs are available for a given Framework/Platform, if you are using APIs that don't exist on your targeted platform (such as .NET Core) and also give you reccomendations for fixing most common issues.

    +

    ApiPort is a tool that analyzes your assemblies and gives you a report on what APIs are available for a given Framework/Platform, if you are using APIs that don't exist on your targeted platform (such as .NET Core) and also give you recommendations for fixing most common issues.

    ApiPort exists in two versions:

    • Console application
      • diff --git a/support/index.md b/support/index.md index 4826e235..50f65a48 100644 --- a/support/index.md +++ b/support/index.md @@ -4,13 +4,13 @@ title: How to get help? --- # Stuck? -If you need help there are a lot of ways you can connect with the team and seek out assistance. +If you need help, you have many ways to connect with the team and seek out assistance. ## StackOverflow -StackOverflow is one of the most used sites for asking general purpose programming questions, and no wonder there is already a [number of existing questions](http://stackoverflow.com/questions/tagged/coreclr) tagged with **coreclr** as well as [questions about Roslyn](http://stackoverflow.com/questions/tagged/roslyn). +StackOverflow is one of the most used sites for asking general-purpose programming questions; it already has a [number of existing questions](http://stackoverflow.com/questions/tagged/coreclr) tagged with **coreclr** as well as [questions about Roslyn](http://stackoverflow.com/questions/tagged/roslyn). ## Gitter channels -[Gitter](https://gitter.im/) is IRC for GitHub projects. There are always people there ready to help with various questions around .NET Core, CoreFX and Roslyn. +[Gitter](https://gitter.im/) is IRC for GitHub projects. There are always people there ready to help with various questions around .NET Core, CoreFX, and Roslyn. * [dotnet/coreclr](https://gitter.im/dotnet/coreclr) * [dotnet/corefx](https://gitter.im/dotnet/corefx) @@ -42,7 +42,7 @@ If you're more of a Facebook fan, you can also visit our Facebook pages on [http # Community meetings/meetups Here is a list of events for the set of .NET user group meetups from [meetup.com](http://meetup.com) and [Community Megaphone](http://communitymegaphone.com/). -We also maintain a much larger list of [.NET meetup groups on Twitter](https://twitter.com/DotNet/dotnet-user-groups). If you would like your group's events listed on either list, please contact us, on [Twitter](http://twitter.com/dotnet). +We also maintain a much larger list of [.NET meetup groups on Twitter](https://twitter.com/DotNet/dotnet-user-groups). If you would like your group's events listed on either list, please contact us on [Twitter](http://twitter.com/dotnet).