Fixing for comments in dotnet#1114

Author: Zlatko Knezevic

Documentation/README.md

@@ -3,19 +3,23 @@ Documents Index
 
 This repo includes several documents that explain both high-level and low-level concepts about the .NET runtime. These are very useful for contributors, to get context that can be very difficult to acquire from just reading code.
 
+Intro to .NET Core
+==================
+
+.NET Core is a self-contained .NET runtime and framework that implements [ECMA 335](dotnet-standards.md). It can be (and has been) ported to multiple architectures and platforms. It support a variety of installation options, having no specific deployment requirements itself.
+
 Learn about .NET Core
 ====================
 
-- [Brief Intro to .NET Core](dotnetcore-intro.md)
 - [[WIP] Official .NET Core Docs](http://dotnet.readthedocs.org)
 
 Get .NET Core
 =============
 
-- [Get .NET Core DNX SDK on Windows](installing/get-dotnetcore-dnx-windows.md)
-- [Get .NET Core DNX SDK on OS X](installing/get-dotnetcore-dnx-osx.md)
-- [Get .NET Core DNX SDK on Linux](installing/get-dotnetcore-dnx-linux.md)
-- [Get .NET Core (Raw) on Windows](installing/get-dotnetcore-windows.md)
+- [Get .NET Core DNX SDK on Windows](install/get-dotnetcore-dnx-windows.md)
+- [Get .NET Core DNX SDK on OS X](install/get-dotnetcore-dnx-osx.md)
+- [Get .NET Core DNX SDK on Linux](install/get-dotnetcore-dnx-linux.md)
+- [Get .NET Core (Raw) on Windows](install/get-dotnetcore-windows.md)
 
 Project Docs
 ============
@@ -68,15 +72,15 @@ Book of the Runtime
 Decoder Rings
 =============
 
-- [.NET Core Glossary](decoders/glossary.md)
-- [.NET Filename Encyclopedia](decoders/dotnet-filenames.md)
+- [.NET Core Glossary](project-docs/glossary.md)
+- [.NET Filename Encyclopedia](project-docs/dotnet-filenames.md)
 
 Other Information
 =================
 
 - [CoreFX Repo documentation](https://github.com/dotnet/corefx/tree/master/Documentation)
 - [Porting to .NET Core](https://github.com/dotnet/corefx/blob/master/Documentation/support-dotnet-core-instructions.md)
-- [.NET Standards (Ecma)](miscellaneous/dotnet-standards.md)
-- [CLR Configuration Knobs](miscellaneous/clr-configuration-knobs.md)
+- [.NET Standards (Ecma)](project-docs/dotnet-standards.md)
+- [CLR Configuration Knobs](project-docs/clr-configuration-knobs.md)
 - [MSDN Entry for the CLR](http://msdn.microsoft.com/library/8bs2ecf4.aspx)
 - [Wikipedia Entry for the CLR](http://en.wikipedia.org/wiki/Common_Language_Runtime)

Documentation/botr/method-descriptor.md

@@ -50,11 +50,11 @@ P/Invoke methods. These are methods marked with DllImport attribute.
 
 **EEImpl**
 
-Delegate methods whose implementation is provided by the runtime (Invoke, BeginInvoke, EndInvoke). See [ECMA 335 Partition II - Delegates](../miscellaneous/dotnet-standards.md).
+Delegate methods whose implementation is provided by the runtime (Invoke, BeginInvoke, EndInvoke). See [ECMA 335 Partition II - Delegates](../project-docs/dotnet-standards.md).
 
 **Array**
 
-Array methods whose implementation is provided by the runtime (Get, Set, Address). See [ECMA Partition II – Arrays](../miscellaneous/dotnet-standards.md).
+Array methods whose implementation is provided by the runtime (Get, Set, Address). See [ECMA Partition II – Arrays](../project-docs/dotnet-standards.md).
 
 **ComInterop**
 

Documentation/botr/ryujit-overview.md

@@ -536,7 +536,7 @@ Below are some of the most useful `COMPLUS` variables. Where {method-list} is sp
 * `COMPLUS_JitTimeLogFile`={file name} – this specifies a log file to which timing information is written.
 * `COMPLUS_JitTimeLogCsv`={file name} – this specifies a log file to which summary timing information can be written, in CSV form.
 
-See also: [CLR Configuration Knobs](../miscellaneous/clr-configuration-knobs.md)
+See also: [CLR Configuration Knobs](../project-docs/clr-configuration-knobs.md)
 
 # Reading a JitDump
 

Documentation/botr/type-system.md

@@ -227,7 +227,7 @@ Major entry points are BuildMethodTable, LoadTypeHandleThrowing, CanCastTo\*, Ge
 Related Reading
 ===============
 
-- [ECMA CLI Specification](../miscellaneous/dotnet-standards.md)
+- [ECMA CLI Specification](../project-docs/dotnet-standards.md)
 - [Type Loader](type-loader.md) Book of the Runtime Chapter
 - [Virtual Stub Dispatch](virtual-stub-dispatch.md) Book of the Runtime Chapter
 - [MethodDesc](method-descriptor.md) Book of the Runtime Chapter

Documentation/building/testing-with-corefx.md

@@ -7,7 +7,7 @@ In order to do this you need to create a file called `localpublish.props` under
 The contents of the file should look like this (make sure to update the version to the current version of the CoreCLR package used by CoreFx):
 
   <Project ToolsVersion="12.0" DefaultTargets="Build" 
-         xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
+         xmlns="http://schemas.microsoft.com/developer/msbuilding/2003">
       <ItemGroup>
       <LocalPackages Include="$(PackagesBinDir)">
           <PackageName>Microsoft.DotNet.CoreCLR</PackageName>

Documentation/dotnetcore-intro.md

@@ -17,7 +17,7 @@ Get .NET Core
 |                     |Linux   |Windows |Mac OS X |FreeBSD  |
 |---------------------|--------|--------|---------|---------|
 |Build from **Source**| [Instructions](Documentation/building/linux-instructions.md) | [Instructions](Documentation/building/windows-instructions.md) | [Instructions](Documentation/building/osx-instructions.md) | [Instructions](Documentation/building/freebsd-instructions.md) |
-|Get **Binaries**     | [DNX SDK](Documentation/installing/get-dotnetcore-dnx-linux.md)|[DNX SDK](Documentation/installing/get-dotnetcore-dnx-windows.md) <br> [Raw](Documentation/installing/get-dotnetcore-windows.md)|[DNX SDK](Documentation/installing/get-dotnetcore-dnx-osx.md)||
+|Get **Binaries**     | [DNX SDK](Documentation/install/get-dotnetcore-dnx-linux.md)|[DNX SDK](Documentation/install/get-dotnetcore-dnx-windows.md) <br> [Raw](Documentation/install/get-dotnetcore-windows.md)|[DNX SDK](Documentation/install/get-dotnetcore-dnx-osx.md)||
 
 Chat Room
 ---------