diff options
| -rw-r--r-- | CONTRIBUTING.md | 4 | ||||
| -rw-r--r-- | Documentation/README.md | 60 | ||||
| -rw-r--r-- | Documentation/building/code-coverage.md (renamed from Documentation/code-coverage.md) | 0 | ||||
| -rw-r--r-- | Documentation/building/unix-instructions.md (renamed from Documentation/unix-instructions.md) | 0 | ||||
| -rw-r--r-- | Documentation/building/windows-instructions.md (renamed from Documentation/windows-instructions.md) | 0 | ||||
| -rw-r--r-- | Documentation/coding-guidelines/breaking-change-definitions.md (renamed from Documentation/breaking-change-definitions.md) | 0 | ||||
| -rw-r--r-- | Documentation/coding-guidelines/breaking-change-rules.md (renamed from Documentation/breaking-change-rules.md) | 0 | ||||
| -rw-r--r-- | Documentation/coding-guidelines/breaking-changes.md (renamed from Documentation/breaking-changes.md) | 0 | ||||
| -rw-r--r-- | Documentation/coding-guidelines/coding-style.md (renamed from Documentation/coding-style.md) | 0 | ||||
| -rw-r--r-- | Documentation/coding-guidelines/cross-platform-guidelines.md (renamed from Documentation/cross-platform-guidelines.md) | 0 | ||||
| -rw-r--r-- | Documentation/coding-guidelines/framework-design-guidelines-digest.md (renamed from Documentation/framework-design-guidelines-digest.md) | 0 | ||||
| -rw-r--r-- | Documentation/coding-guidelines/interop-guidelines.md (renamed from Documentation/interop-guidelines.md) | 0 | ||||
| -rw-r--r-- | Documentation/coding-guidelines/performance-guidelines.md (renamed from Documentation/performance-guidelines.md) | 2 | ||||
| -rw-r--r-- | Documentation/project-docs/api-review-process.md (renamed from Documentation/api-review-process.md) | 2 | ||||
| -rw-r--r-- | Documentation/project-docs/branching-guide.md (renamed from Documentation/branching-guide.md) | 0 | ||||
| -rw-r--r-- | Documentation/project-docs/contributing.md (renamed from Documentation/contributing.md) | 4 | ||||
| -rw-r--r-- | Documentation/project-docs/developer-guide.md (renamed from Documentation/developer-guide.md) | 0 | ||||
| -rw-r--r-- | Documentation/project-docs/issue-guide.md (renamed from Documentation/issue-guide.md) | 0 | ||||
| -rw-r--r-- | Documentation/project-docs/oss-signing.md (renamed from Documentation/oss-signing.md) | 0 | ||||
| -rw-r--r-- | Documentation/project-docs/repo-organization.md (renamed from Documentation/repo-organization.md) | 0 | ||||
| -rw-r--r-- | Documentation/project-docs/strong-name-signing.md (renamed from Documentation/strong-name-signing.md) | 0 | ||||
| -rw-r--r-- | Documentation/project-docs/support-dotnet-core-instructions.md (renamed from Documentation/support-dotnet-core-instructions.md) | 10 | ||||
| -rw-r--r-- | README.md | 14 |
23 files changed, 51 insertions, 45 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index e1f9afc3f8..2637b25cc0 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,7 +1,7 @@ # Contributing -See [Contributing](Documentation/contributing.md) for information about coding styles, source structure, making pull requests, and more. +See [Contributing](Documentation/project-docs/contributing.md) for information about coding styles, source structure, making pull requests, and more. # Developers -See the [Developer Guide](Documentation/developer-guide.md) for details about developing in this repo. +See the [Developer Guide](Documentation/project-docs/developer-guide.md) for details about developing in this repo. diff --git a/Documentation/README.md b/Documentation/README.md index 7e3248f23b..cda8094b2b 100644 --- a/Documentation/README.md +++ b/Documentation/README.md @@ -1,58 +1,62 @@ Documents Index =============== +Intro to .NET Core +================== + +.NET Core is a self-contained .NET runtime and framework that implements ECMA 335. 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](https://github.com/dotnet/coreclr/blob/master/Documentation/dotnetcore-intro.md) - [[WIP] Official .NET Core Docs](http://dotnet.readthedocs.org) Get .NET Core ============= -- [Get .NET Core DNX SDK on Windows](https://github.com/dotnet/coreclr/blob/master/Documentation/get-dotnetcore-dnx-windows.md) -- [Get .NET Core DNX SDK on OS X](https://github.com/dotnet/coreclr/blob/master/Documentation/get-dotnetcore-dnx-osx.md) -- [Get .NET Core DNX SDK on Linux](https://github.com/dotnet/coreclr/blob/master/Documentation/get-dotnetcore-dnx-linux.md) -- [Get .NET Core (Raw) on Windows](https://github.com/dotnet/coreclr/blob/master/Documentation/get-dotnetcore-windows.md) +- [Get .NET Core DNX SDK on Windows](https://github.com/dotnet/coreclr/blob/master/Documentation/install/get-dotnetcore-dnx-windows.md) +- [Get .NET Core DNX SDK on OS X](https://github.com/dotnet/coreclr/blob/master/Documentation/install/get-dotnetcore-dnx-osx.md) +- [Get .NET Core DNX SDK on Linux](https://github.com/dotnet/coreclr/blob/master/Documentation/install/get-dotnetcore-dnx-linux.md) +- [Get .NET Core (Raw) on Windows](https://github.com/dotnet/coreclr/blob/master/Documentation/install/get-dotnetcore-windows.md) Project Docs ============ -- [Developer Guide](developer-guide.md) -- [Project priorities](https://github.com/dotnet/coreclr/blob/master/Documentation/project-priorities.md) -- [Contributing to CoreFX](contributing.md) -- [Contributing to .NET Core](https://github.com/dotnet/coreclr/blob/master/Documentation/contributing.md) -- [Contributing Workflow](https://github.com/dotnet/coreclr/blob/master/Documentation/contributing-workflow.md) -- [Issue Guide](issue-guide.md) -- [Branching Guide](branching-guide.md) -- [API Review Process](api-review-process.md) -- [Strong Name Signing](strong-name-signing.md) -- [Open Source Signing](oss-signing.md) -- [Repo Organization](repo-organization.md) +- [Developer Guide](project-docs/developer-guide.md) +- [Project priorities](https://github.com/dotnet/coreclr/blob/master/Documentation/project-docs/project-priorities.md) +- [Contributing to CoreFX](project-docs/contributing.md) +- [Contributing to .NET Core](https://github.com/dotnet/coreclr/blob/master/Documentation/project-docs/contributing.md) +- [Contributing Workflow](https://github.com/dotnet/coreclr/blob/master/Documentation/project-docs/contributing-workflow.md) +- [Issue Guide](project-docs/issue-guide.md) +- [Branching Guide](project-docs/branching-guide.md) +- [API Review Process](project-docs/api-review-process.md) +- [Strong Name Signing](project-docs/strong-name-signing.md) +- [Open Source Signing](project-docs/oss-signing.md) +- [Repo Organization](project-docs/repo-organization.md) Coding Guidelines ================= -- [C# coding style](coding-style.md) -- [Framework Design Guidelines](framework-design-guidelines-digest.md) -- [Cross-Platform Guidelines](cross-platform-guidelines.md) -- [Performance Guidelines](performance-guidelines.md) -- [Interop Guidelines](interop-guidelines.md) -- [Breaking Changes](breaking-changes.md) -- [Breaking Change Definitions](breaking-change-definitions.md) -- [Breaking Change Rules](breaking-change-rules.md) +- [C# coding style](coding-guidelines/coding-style.md) +- [Framework Design Guidelines](coding-guidelines/framework-design-guidelines-digest.md) +- [Cross-Platform Guidelines](coding-guidelines/cross-platform-guidelines.md) +- [Performance Guidelines](coding-guidelines/performance-guidelines.md) +- [Interop Guidelines](coding-guidelines/interop-guidelines.md) +- [Breaking Changes](coding-guidelines/breaking-changes.md) +- [Breaking Change Definitions](coding-guidelines/breaking-change-definitions.md) +- [Breaking Change Rules](coding-guidelines/breaking-change-rules.md) Building from Source ==================== -- [Building CoreFX on FreeBSD, Linux and OS X](unix-instructions.md) -- [Code Coverage](code-coverage.md) +- [Building CoreFX on FreeBSD, Linux and OS X](building/unix-instructions.md) +- [Code Coverage](building/code-coverage.md) Other Information ================= - [CoreCLR Repo documentation](https://github.com/dotnet/coreclr/tree/master/Documentation) -- [Porting to .NET Core](support-dotnet-core-instructions.md) -- [.NET Standards (Ecma)](https://github.com/dotnet/coreclr/blob/master/Documentation/dotnet-standards.md) +- [Porting to .NET Core](project-docs/support-dotnet-core-instructions.md) +- [.NET Standards (Ecma)](https://github.com/dotnet/coreclr/blob/master/Documentation/project-docs/dotnet-standards.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) diff --git a/Documentation/code-coverage.md b/Documentation/building/code-coverage.md index 4d9467241c..4d9467241c 100644 --- a/Documentation/code-coverage.md +++ b/Documentation/building/code-coverage.md diff --git a/Documentation/unix-instructions.md b/Documentation/building/unix-instructions.md index fa28442bc4..fa28442bc4 100644 --- a/Documentation/unix-instructions.md +++ b/Documentation/building/unix-instructions.md diff --git a/Documentation/windows-instructions.md b/Documentation/building/windows-instructions.md index 2f84edb26d..2f84edb26d 100644 --- a/Documentation/windows-instructions.md +++ b/Documentation/building/windows-instructions.md diff --git a/Documentation/breaking-change-definitions.md b/Documentation/coding-guidelines/breaking-change-definitions.md index 7c34f866d8..7c34f866d8 100644 --- a/Documentation/breaking-change-definitions.md +++ b/Documentation/coding-guidelines/breaking-change-definitions.md diff --git a/Documentation/breaking-change-rules.md b/Documentation/coding-guidelines/breaking-change-rules.md index 27a5d64dba..27a5d64dba 100644 --- a/Documentation/breaking-change-rules.md +++ b/Documentation/coding-guidelines/breaking-change-rules.md diff --git a/Documentation/breaking-changes.md b/Documentation/coding-guidelines/breaking-changes.md index 1f6b1d0609..1f6b1d0609 100644 --- a/Documentation/breaking-changes.md +++ b/Documentation/coding-guidelines/breaking-changes.md diff --git a/Documentation/coding-style.md b/Documentation/coding-guidelines/coding-style.md index a909488c69..a909488c69 100644 --- a/Documentation/coding-style.md +++ b/Documentation/coding-guidelines/coding-style.md diff --git a/Documentation/cross-platform-guidelines.md b/Documentation/coding-guidelines/cross-platform-guidelines.md index bcb02bb56c..bcb02bb56c 100644 --- a/Documentation/cross-platform-guidelines.md +++ b/Documentation/coding-guidelines/cross-platform-guidelines.md diff --git a/Documentation/framework-design-guidelines-digest.md b/Documentation/coding-guidelines/framework-design-guidelines-digest.md index 1337ad8461..1337ad8461 100644 --- a/Documentation/framework-design-guidelines-digest.md +++ b/Documentation/coding-guidelines/framework-design-guidelines-digest.md diff --git a/Documentation/interop-guidelines.md b/Documentation/coding-guidelines/interop-guidelines.md index edb3936cd2..edb3936cd2 100644 --- a/Documentation/interop-guidelines.md +++ b/Documentation/coding-guidelines/interop-guidelines.md diff --git a/Documentation/performance-guidelines.md b/Documentation/coding-guidelines/performance-guidelines.md index 477c8a9e6a..a991a0ad30 100644 --- a/Documentation/performance-guidelines.md +++ b/Documentation/coding-guidelines/performance-guidelines.md @@ -5,7 +5,7 @@ Different applications have different needs when it comes to performance. For l Much has been written about writing high-performance code in C#. This page provides links to some of that material and will expand over time as additional resources are found and identified as being relevant and useful. -You can read [CoreCLR Performance Requirements](https://github.com/master/coreclr/blob/master/Documentation/performance-requirements.md) to learn more. +You can read [CoreCLR Performance Requirements](https://github.com/dotnet/coreclr/blob/master/Documentation/project-docs/performance-guidelines.md) to learn more. # Memory Management diff --git a/Documentation/api-review-process.md b/Documentation/project-docs/api-review-process.md index 3bc6991771..0b6319092c 100644 --- a/Documentation/api-review-process.md +++ b/Documentation/project-docs/api-review-process.md @@ -21,7 +21,7 @@ For trivial code changes, such as typo fixes, we want folks to directly submit a For work that involves adding new APIs we'd like the issue to contain what we call a *speclet*. The speclet should provide a rough sketch of how the APIs are intended to be used, with sample code that shows typical scenarios. The goal isn't to be complete but rather to illustrate the direction so that readers can judge whether the proposal is sound. Here is [a good example](https://github.com/dotnet/corefx/issues/271). - + ## Steps diff --git a/Documentation/branching-guide.md b/Documentation/project-docs/branching-guide.md index b67a65d751..b67a65d751 100644 --- a/Documentation/branching-guide.md +++ b/Documentation/project-docs/branching-guide.md diff --git a/Documentation/contributing.md b/Documentation/project-docs/contributing.md index 25ded4a1a2..b9ebc67474 100644 --- a/Documentation/contributing.md +++ b/Documentation/project-docs/contributing.md @@ -1,14 +1,14 @@ Contributing to CoreFX ====================== -This document describes contribution guidelines that are specific to CoreFX. Please read [.NET Core Guidelines](https://github.com/dotnet/coreclr/blob/master/Documentation/contributing.md) for more general .NET Core contribution guidelines. +This document describes contribution guidelines that are specific to CoreFX. Please read [.NET Core Guidelines](https://github.com/dotnet/coreclr/blob/master/Documentation/project-docs/contributing.md) for more general .NET Core contribution guidelines. Coding Style Changes -------------------- We intend to bring dotnet/corefx in to full conformance with the style guidelines described in [Coding Style](coding-style.md). We plan to do that with tooling, in a holistic way. In the meantime, please: -* **DO NOT** send PRs for style changes. +* **DO NOT** send PRs for style changes. * **DO** give priority to the current style of the project or file you're changing even if it diverges from the general guidelines. API Changes diff --git a/Documentation/developer-guide.md b/Documentation/project-docs/developer-guide.md index c5f8da8e74..c5f8da8e74 100644 --- a/Documentation/developer-guide.md +++ b/Documentation/project-docs/developer-guide.md diff --git a/Documentation/issue-guide.md b/Documentation/project-docs/issue-guide.md index a1f669a2a7..a1f669a2a7 100644 --- a/Documentation/issue-guide.md +++ b/Documentation/project-docs/issue-guide.md diff --git a/Documentation/oss-signing.md b/Documentation/project-docs/oss-signing.md index 2e8616f9e8..2e8616f9e8 100644 --- a/Documentation/oss-signing.md +++ b/Documentation/project-docs/oss-signing.md diff --git a/Documentation/repo-organization.md b/Documentation/project-docs/repo-organization.md index 686db5b0c3..686db5b0c3 100644 --- a/Documentation/repo-organization.md +++ b/Documentation/project-docs/repo-organization.md diff --git a/Documentation/strong-name-signing.md b/Documentation/project-docs/strong-name-signing.md index ce3543fde9..ce3543fde9 100644 --- a/Documentation/strong-name-signing.md +++ b/Documentation/project-docs/strong-name-signing.md diff --git a/Documentation/support-dotnet-core-instructions.md b/Documentation/project-docs/support-dotnet-core-instructions.md index 494f9458e9..ea3b948545 100644 --- a/Documentation/support-dotnet-core-instructions.md +++ b/Documentation/project-docs/support-dotnet-core-instructions.md @@ -12,21 +12,21 @@ Want to make your libraries multi-platform? Want to see how much work is require To begin using the .NET Portability Analyzer, download the extension from the Visual Studio Gallery. You can configure it in Visual Studio via *Tools* >> *Options* >> *.NET Portability Analyzer* and select your Target Platforms. For now, please use ASP.NET 5 as a proxy for all .NET Core 5-based platforms (e.g. [Windows 10 .NET UAP apps](http://blogs.windows.com/buildingapps/2015/03/02/a-first-look-at-the-windows-10-universal-app-platform/)). - + To analyze your entire project, right-click on your project in the Solution Explorer and select *Analyze* >> *Analyze Assembly Portability*. Otherwise, go to the Analyze menu and select *Analyze Assembly Portability*. From there, select your project's executable or .dll. - + After running the analysis, you will see your .NET Portability Report. Only types that are unsupported by a target platform will appear in the list and you can review recommendations in the **Messages** tab in the **Error List**. You can also jump to problem areas directly from the **Messages** tab. - + Don't want to use Visual Studio? You can also use the Portability Analyzer from the Command Prompt. Download the command-line analyzer [here](http://www.microsoft.com/en-us/download/details.aspx?id=42678). - Type the following command to analyze the current directory: ```\...\ApiPort.exe . ``` -- To analyze a specific list of .dlls type the following command: ```\...\ApiPort.exe first.dll second.dll third.dll ``` +- To analyze a specific list of .dlls type the following command: ```\...\ApiPort.exe first.dll second.dll third.dll ``` Your .NET Portability Report will be saved as an Excel .xlsx file in your current directory. The **Details** tab in the Excel Workbook will contain more info. -For more info on the .NET Portability Analyzer, read [this article](http://blogs.msdn.com/b/dotnet/archive/2014/08/06/leveraging-existing-code-across-net-platforms.aspx). +For more info on the .NET Portability Analyzer, read [this article](http://blogs.msdn.com/b/dotnet/archive/2014/08/06/leveraging-existing-code-across-net-platforms.aspx). @@ -8,9 +8,11 @@ The corefx repo contains the library implementation (called "CoreFX") for [.NET Core](http://github.com/dotnet/core). It includes System.Collections, System.IO, System.Xml and many other components. It builds and runs on Windows. You can ['watch'](https://github.com/dotnet/corefx/subscription) the repo to see Linux and Mac support being added over the next few months. -.NET Core is a modular implementation of .NET that can be used as the base stack for a wide variety of scenarios, today scaling from console utilities to web apps in the cloud. You can learn more about .NET Core and how and where you can use it in the [.NET Core is open source][.NET Core oss] and [Introducing .NET Core][Introducing .NET Core] blog posts. +You can also see more information in the [Documentation README](Documentation/README.md). -The [.NET Core Runtime repo](https://github.com/dotnet/coreclr) contains the runtime implementation (called "CoreCLR") for .NET Core. It includes RyuJIT, the .NET GC, native interop and many other components. +.NET Core is a modular implementation of .NET that can be used as the base stack for a wide variety of scenarios, today scaling from console utilities to web apps in the cloud. You can learn more about .NET Core and how and where you can use it in the [.NET Core is open source][.NET Core oss] and [Introducing .NET Core][Introducing .NET Core] blog posts. + +The [.NET Core Runtime repo](https://github.com/dotnet/coreclr) contains the runtime implementation (called "CoreCLR") for .NET Core. It includes RyuJIT, the .NET GC, native interop and many other components. Runtime-specific library code - namely [mscorlib][mscorlib] - lives in the CoreCLR repo. It needs to be built and versioned in tandem with the runtime. The rest of CoreFX is agnostic of runtime-implementation and can be run on any compatible .NET runtime. These characteristics were the primary motivation for the 2-repo structure. @@ -20,7 +22,7 @@ Runtime-specific library code - namely [mscorlib][mscorlib] - lives in the CoreC ## How to Engage, Contribute and Provide Feedback -Some of the best ways to contribute are to try things out, file bugs, and join in design conversations. +Some of the best ways to contribute are to try things out, file bugs, and join in design conversations. Want to get more familiar with what's going on in the code? * [Pull requests](https://github.com/dotnet/corefx/pulls): [Open](https://github.com/dotnet/corefx/pulls?q=is%3Aopen+is%3Apr)/[Closed](https://github.com/dotnet/corefx/pulls?q=is%3Apr+is%3Aclosed) @@ -28,9 +30,9 @@ Want to get more familiar with what's going on in the code? Looking for something to work on? The list of [up-for-grabs issues](https://github.com/dotnet/corefx/labels/up%20for%20grabs) is a great place to start or for larger items see the list of [feature approved](https://github.com/dotnet/corefx/labels/feature%20approved). See some of our guides for more details: -* [Contributing Guide](Documentation/contributing.md) -* [Developer Guide](Documentation/developer-guide.md) -* [Issue Guide](Documentation/issue-guide.md) +* [Contributing Guide](Documentation/project-docs/contributing.md) +* [Developer Guide](Documentation/project-docs/developer-guide.md) +* [Issue Guide](Documentation/project-docs/issue-guide.md) You are also encouraged to start a discussion by filing an issue or creating a gist. |