Documentation/README.md

   1 Documents Index
   2 ===============
   3
   4 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.
   5
   6 Intro to .NET Core
   7 ==================
   8
   9 .NET Core is a self-contained .NET runtime and framework that implements [ECMA 335](project-docs/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.
  10
  11 Learn about .NET Core
  12 ====================
  13
  14 - [[WIP] Official .NET Core Docs](http://dotnet.readthedocs.org)
  15
  16 Get .NET Core
  17 =============
  18
  19 - [Get .NET Core DNX SDK on Windows](install/get-dotnetcore-dnx-windows.md)
  20 - [Get .NET Core DNX SDK on OS X](install/get-dotnetcore-dnx-osx.md)
  21 - [Get .NET Core DNX SDK on Linux](install/get-dotnetcore-dnx-linux.md)
  22 - [Get .NET Core (Raw) on Windows](install/get-dotnetcore-windows.md)
  23
  24 Project Docs
  25 ============
  26
  27 - [Developer Guide](project-docs/developer-guide.md)
  28 - [Project priorities](project-docs/project-priorities.md)
  29 - [Contributing to .NET Core](project-docs/contributing.md)
  30 - [Contributing Workflow](project-docs/contributing-workflow.md)
  31 - [Performance Guidelines](project-docs/performance-guidelines.md)
  32 - [Garbage Collector Guidelines](project-docs/garbage-collector-guidelines.md)
  33 - [Adding new public APIs to mscorlib](project-docs/adding_new_public_apis.md)
  34
  35 Coding Guidelines
  36 =================
  37
  38 - [CLR Coding Guide](coding-guidelines/clr-code-guide.md)
  39 - [CLR JIT Coding Conventions](coding-guidelines/clr-jit-coding-conventions.md)
  40 - [Cross Platform Performance and Eventing Design](coding-guidelines/cross-platform-performance-and-eventing.md)
  41
  42 Build CoreCLR from Source
  43 =========================
  44
  45 - [Building CoreCLR on FreeBSD](building/freebsd-instructions.md)
  46 - [Building CoreCLR on Linux](building/linux-instructions.md)
  47 - [Building CoreCLR on OS X](building/osx-instructions.md)
  48 - [Building CoreCLR on Windows](building/windows-instructions.md)
  49 - [Debugging CoreCLR on Windows](building/windows-debugging-instructions.md)
  50 - [Testing Changes on Windows](building/windows-test-instructions.md)
  51 - [Testing Changes on Linux, OS X, and FreeBSD](building/unix-test-instructions.md)
  52 - [Testing with CoreFX](building/testing-with-corefx.md)
  53 - [Creating a Custom DNX](building/custom-dnx-instructions.md)
  54
  55 Book of the Runtime
  56 ===================
  57
  58 - [Book of the Runtime FAQ](botr/botr-faq.md)
  59 - [Introduction to the Common Language Runtime](botr/intro-to-clr.md)
  60 - [Garbage Collection Design](botr/garbage-collection.md)
  61 - [Threading](botr/threading.md)
  62 - [RyuJIT Overview](botr/ryujit-overview.md)
  63 - [Type System](botr/type-system.md)
  64 - [Type Loader](botr/type-loader.md)
  65 - [Method Descriptor](botr/method-descriptor.md)
  66 - [Virtual Stub Dispatch](botr/virtual-stub-dispatch.md)
  67 - [Stack Walking](botr/stackwalking.md)
  68 - [Mscorlib and Calling Into the Runtime](botr/mscorlib.md)
  69 - [Data Access Component (DAC) Notes](botr/dac-notes.md)
  70 - [Profiling](botr/profiling.md)
  71 - [Implementing Profilability](botr/profilability.md)
  72 - [What Every Dev needs to Know About Exceptions in the Runtime](botr/exceptions.md)
  73 - [ReadyToRun Overview](botr/readytorun-overview.md)
  74
  75 Decoder Rings
  76 =============
  77
  78 - [.NET Core Glossary](project-docs/glossary.md)
  79 - [.NET Filename Encyclopedia](project-docs/dotnet-filenames.md)
  80
  81 Other Information
  82 =================
  83
  84 - [CoreFX Repo documentation](https://github.com/dotnet/corefx/tree/master/Documentation)
  85 - [Porting to .NET Core](https://github.com/dotnet/corefx/blob/master/Documentation/project-docs/support-dotnet-core-instructions.md)
  86 - [.NET Standards (Ecma)](project-docs/dotnet-standards.md)
  87 - [CLR Configuration Knobs](project-docs/clr-configuration-knobs.md)
  88 - [MSDN Entry for the CLR](http://msdn.microsoft.com/library/8bs2ecf4.aspx)
  89 - [Wikipedia Entry for the CLR](http://en.wikipedia.org/wiki/Common_Language_Runtime)