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
============
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)
**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**
* `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
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
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>
+++ /dev/null
-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.
| |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
---------