Copy Editing

_includes/gs/docker_gs.html

@@ -3,7 +3,7 @@
     <div class="step step-none docker-trail" id="step-1">
       <div class="step-number">1</div>
       <h3>Install Docker</h3>
-      <p>Before you can try out the .NET Core Docker base images, you should install Docker. Refer to <a href="http://docs.docker.com/mac/started/">Mac</a> or <a href="http://docs.docker.com/windows/started/">Windows</a> or <a href="http://docs.docker.com/linux/started/">Linux</a> getting started instructions for Docker.</p>
+      <p>Before you can try out the .NET Core Docker base images, you should install Docker. Refer to <a href="http://docs.docker.com/mac/started/">Mac</a>, <a href="http://docs.docker.com/windows/started/">Windows</a> or <a href="http://docs.docker.com/linux/started/">Linux</a> getting started instructions for Docker.</p>
     </div>
     <div class="step step-none docker-trail" id="step-2">
       <div class="step-number">2</div>

_includes/gs/linux_gs.html

@@ -4,7 +4,7 @@
       <div class="step-number">1</div>
       <h3>Add the new apt-get feed</h3>
       <p>In order to install .NET Core on Ubuntu, we need to first set up the apt-get feed that hosts the package we need.</p>
-      <p><strong>Note:</strong> 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.</p>
+      <p><strong>Note:</strong> 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.</p>
       <div class="terminal">
         <div class="terminal-titlebar"></div>
         <div class="terminal-body">
@@ -18,7 +18,7 @@ <h3>Add the new apt-get feed</h3>
     <div class="step step-none linux-trail" id="step-2">
       <div class="step-number">2</div>
       <h3>Install .NET Core</h3>
-      <p>Installing .NET Core is a simple thing on Ubuntu. The below will install the package and all of its dependencies.</p>
+      <p>Installing .NET Core is a simple thing on Ubuntu. The below will install the package and all of its dependencies:</p>
       <div class="terminal">
         <div class="terminal-titlebar"></div>
         <div class="terminal-body">

_includes/gs/macosx_gs.html

@@ -22,7 +22,7 @@ <h3>Initialize some code</h3>
     <div class="step step-none macosx-trail" id="step-3">
       <div class="step-number">3</div>
       <h3>Run the app</h3>
-      <p>The first command will restore the packages specified in the <strong>project.json</strong> file, and the second command will run the actuall sample:</p>
+      <p>The first command will restore the packages specified in the <strong>project.json</strong> file, and the second command will run the actual sample:</p>
       <div class="terminal">
         <div class="terminal-titlebar"></div>
         <div class="terminal-body">

_includes/hero.html

@@ -2,7 +2,7 @@
 
   <div class="starter-template">
     <h1 class="dotnet">.NET Core</h1>
-    <p class="lead">A general purpose managed framework</p>
+    <p class="lead">A general-purpose managed framework</p>
     <!-- Standard button -->
     <a href="/getting-started/" class="btn-hero-core">Getting started</a>
     <a href="/about/" class="btn-hero-core">About .NET Core</a>

_includes/value_props.html

@@ -4,17 +4,17 @@
       <div class="col-lg-4 text-center animated fadeInLeft">
         <span class="fa fa-cubes fa-3x"></span>
         <h2 class="value-prop-heading">Modular</h2>
-        <p>.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.</p>
+        <p>.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.</p>
       </div><!-- /.col-lg-4 -->
       <div class="col-lg-4 text-center  animated fadeIn">
         <span class="fa fa-code fa-3x"></span>
         <h2 class="value-prop-heading">Managed</h2>
-        <p>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. </p>
+        <p>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. </p>
       </div><!-- /.col-lg-4 -->
       <div class="col-lg-4 text-center animated fadeInRight">
         <span class="fa fa-linux fa-3x"></span>
         <h2 class="value-prop-heading">Cross-platform</h2>
-        <p>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.</p>
+        <p>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.</p>
       </div><!-- /.col-lg-4 -->
     </div><!-- /.row -->
   </div>

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.

docs/concepts/editions-overview.html

@@ -1,4 +1,4 @@
-<!DOCTYPE html>
+<!DOCTYPE html>
 <!--[if IE]><![endif]-->
 <html>
 
@@ -72,7 +72,7 @@ <h1 id="overview-of-net-implementations">Overview of .NET Implementations</h1>
 <p>The .NET Platform is described by a set of <a href="https://github.com/dotnet/coreclr/blob/master/Documentation/project-docs/dotnet-standards.md">open standards</a> that define its architecture and semantic behavior. The <a href="https://github.com/dotnet/coreclr/blob/master/Documentation/project-docs/dotnet-standards.md#ecma-335---cli">ECMA 335</a> 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.</p>
 <p>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 <a href="https://github.com/dotnet/corefx/blob/master/Documentation/project-docs/standard-platform.md">.NET Platform Standard</a> define portable API sets that are supported by multiple .NET implementations, making it possible to run unmodified libraries across multiple .NET implementations.</p>
 <h2 id="-net-core">.NET Core</h2>
-<p>.NET Core is a general purpose and cross-platform implementation of the .NET Platform. <a href="https://github.com/aspnet/home">ASP.NET Core</a> is the primary workload that runs on .NET Core.</p>
+<p>.NET Core is a general-purpose and cross-platform implementation of the .NET Platform. <a href="https://github.com/aspnet/home">ASP.NET Core</a> is the primary workload that runs on .NET Core.</p>
 <p>The following are the main characteristics of .NET Core:</p>
 <p><strong>Cross-platform</strong> - .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.</p>
 <p><strong>Open Source</strong> - <a href="https://github.com/dotnet/core">.NET Core</a> is available on GitHub, licensed with the <a href="https://github.com/dotnet/coreclr/blob/master/LICENSE.TXT">MIT</a> and <a href="https://github.com/dotnet/roslyn/blob/master/License.txt">Apache 2</a> licenses (licensing is per component). It also makes use of a significant set of open source industry <a href="https://github.com/dotnet/core/releases">dependencies</a> (see release notes). </p>

docs/concepts/primer.html

@@ -1,4 +1,4 @@
-<!DOCTYPE html>
+<!DOCTYPE html>
 <!--[if IE]><![endif]-->
 <html>
 
@@ -70,7 +70,7 @@
               <h1 id="-net-primer">.NET Primer</h1>
 
 <p>By <a href="https://github.com/richlander">Rich Lander</a>, <a href="https://github.com/blackdwarf">Zlatko Knezevic</a></p>
-<p>.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.</p>
+<p>.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.</p>
 <p>Multiple implementations of .NET are available, based on open <a href="https://github.com/dotnet/coreclr/blob/master/Documentation/project-docs/dotnet-standards.md">.NET Standards</a> 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.</p>
 <p>You can take a look at the <a href="editions-overview.html">Overview of .NET implementations</a> document to figure out all of the different editions of the .NET Framework that are available, both Microsoft’s and others.</p>
 <h2 id="key-net-concepts">Key .NET Concepts</h2>

docs/index.html

@@ -1,4 +1,4 @@
-<!DOCTYPE html>
+<!DOCTYPE html>
 <!--[if IE]><![endif]-->
 <html>
 
@@ -69,7 +69,7 @@
               <a href="https://github.com/dotnet/core-docs/blob/master/docs/index.md/#L1" class="pull-right mobile-hide"><span class="fa fa-github"></span> Improve this Doc</a>
               <h2 id="getting-started">Getting started</h2>
 
-<p>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. </p>
+<p>In this website, you will find tutorials that will teach you how to get started with .NET Core. You can also find the <a href="http://dotnet.github.io/api/index.html">API reference documentation</a>. </p>
 <h2 id="what-kinds-of-applications-do-you-want-to-build-">What kinds of applications do you want to build?</h2>
 <ul>
 <li><a href="getting-started/index.html">Console application</a></li>

docs/libraries/libraries-with-cli.html

@@ -1,13 +1,13 @@
-<!DOCTYPE html>
+<!DOCTYPE html>
 <!--[if IE]><![endif]-->
 <html>
 
   <head>
     <meta charset="utf-8">
     <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
-    <title>Writing Libraries with Cross Platform Tools | CoreCLR site</title>
+    <title>Writing Libraries with Cross-Platform Tools | CoreCLR site</title>
     <meta name="viewport" content="width=device-width">
-    <meta name="title" content="Writing Libraries with Cross Platform Tools | CoreCLR site">
+    <meta name="title" content="Writing Libraries with Cross-Platform Tools | CoreCLR site">
 
     <link rel="shortcut icon" href="../../images/Logo_DotNet.png" type="image/x-icon">
     <link rel="stylesheet" href="http://maxcdn.bootstrapcdn.com/font-awesome/4.3.0/css/font-awesome.min.css">
@@ -67,7 +67,7 @@
           <div class="col-md-10">
             <article class="content wrap" id="_content">
               <a href="https://github.com/dotnet/core-docs/blob/master/docs/libraries/libraries-with-cli.md/#L1" class="pull-right mobile-hide"><span class="fa fa-github"></span> Improve this Doc</a>
-              <h1 id="writing-libraries-with-cross-platform-tools">Writing Libraries with Cross Platform Tools</h1>
+              <h1 id="writing-libraries-with-cross-platform-tools">Writing Libraries with Cross-Platform Tools</h1>
 
 <p>By <a href="https://github.com/cartermp">Phillip Carter</a></p>
 <p><strong>Some details are subject to change as the toolchain evolves.</strong></p>

docs/libraries/overview.html

@@ -1,4 +1,4 @@
-<!DOCTYPE html>
+<!DOCTYPE html>
 <!--[if IE]><![endif]-->
 <html>
 
@@ -71,7 +71,7 @@ <h1 id="overview">Overview</h1>
 
 <p>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.</p>
 <ul>
-<li><a href="libraries-with-cli.html">Writing Libraries with Cross Platform Tools</a></li>
+<li><a href="libraries-with-cli.html">Writing Libraries with Cross-Platform Tools</a></li>
 <li><a href="libraries-with-vs.html">Creating Libraries in Visual Studio</a></li>
 </ul>
 

docs/toc.html

@@ -1,4 +1,4 @@
-<!DOCTYPE html>
+<!DOCTYPE html>
 <!--[if IE]><![endif]-->
 <html>
 
@@ -179,7 +179,7 @@
                                     <a href="libraries/overview.html" name="" title="Overview">Overview</a>
                                   </li>
                                   <li>
-                                    <a href="libraries/libraries-with-cli.html" name="" title="Creating a class library with Cross Platform Tools">Creating a class library with Cross Platform Tools</a>
+                                    <a href="libraries/libraries-with-cli.html" name="" title="Creating a class library with Cross-Platform Tools">Creating a class library with Cross Platform Tools</a>
                                   </li>
                                   <li>
                                     <a href="libraries/libraries-with-vs.html" name="" title="Creating a class library in Visual Studio">Creating a class library in Visual Studio</a>
@@ -396,7 +396,7 @@
                                 <a href="libraries/overview.html" name="" title="Overview">Overview</a>
                               </li>
                               <li>
-                                <a href="libraries/libraries-with-cli.html" name="" title="Creating a class library with Cross Platform Tools">Creating a class library with Cross Platform Tools</a>
+                                <a href="libraries/libraries-with-cli.html" name="" title="Creating a class library with Cross-Platform Tools">Creating a class library with Cross Platform Tools</a>
                               </li>
                               <li>
                                 <a href="libraries/libraries-with-vs.html" name="" title="Creating a class library in Visual Studio">Creating a class library in Visual Studio</a>
@@ -500,4 +500,4 @@
     <script type="text/javascript" src="../styles/main.js"></script>
     <script>hljs.initHighlightingOnLoad();</script>
   </body>
-</html>
+</html>

porting/index.html

@@ -22,7 +22,7 @@ <h1>Porting to .NET Core</h1>
         <h2>Tools to help you port</h2>
         <p>In this section you will find tools that can help you with porting your code to .NET Core.</p>
         <h3>ApiPort</h3>
-        <p>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.</p>
+        <p>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.</p>
         <p>ApiPort exists in two versions:</p>
         <ul>
             <li><a href="https://github.com/Microsoft/dotnet-apiport/releases">Console application</a></li>