Add a design index

INDEX.md

@@ -0,0 +1,84 @@
+<!--
+
+This file is auto-generated. Direct changes to it maybe lost.
+
+Use update-index to regenerate it:
+
+    ./update-index > INDEX.md
+
+-->
+
+# Meta
+
+| Design Name |
+| ----------- |
+| [Proposal Template](meta/template.md) |
+| [Proposals](meta/proposals.md) |
+
+# Accepted
+
+| Year | Design Name | Owner |
+| ---- | ----------- | ----- |
+| 2018 | [.NET Core SDK Versioning](accepted/2018/sdk-version-scheme.md) | [Kathleen Dollard](https://github.com/KathleenDollard) |
+| 2018 | [.NET Platform Dependent Intrinsics](accepted/2018/platform-intrinsics.md) | [Russell Hadley](https://github.com/russellhadley) |
+| 2018 | [Automatic Binding Redirection By Default](accepted/2018/automatic-redirects-by-default/automatic-redirects-by-default.md) | [Immo Landwerth](https://github.com/terrajobst), [Rainer Sigwald](https://github.com/rainersigwald) |
+| 2018 | [CLI Syntax Guidelines](accepted/2018/cli-syntax-guideline.md) | [Kathleen Dollard](https://github.com/KathleenDollard) |
+| 2018 | [Cross-Platform Performance Monitoring Design](accepted/2018/cross-platform-performance-monitoring.md) | [Brian Robbins](https://github.com/brianrob) |
+| 2018 | [Extensible File Enumeration](accepted/2018/file-enumeration.md) | [Immo Landwerth](https://github.com/terrajobst), [Jeremy Kuhne](https://github.com/jeremykuhne) |
+| 2018 | [Package Information in API Reference](accepted/2018/package-doc/package-doc.md) | [Immo Landwerth](https://github.com/terrajobst), [Wes Haggard](https://github.com/weshaggard) |
+| 2018 | [Performance Profiling Controller Design](accepted/2018/performance-profiling-controller.md) | [Brian Robbins](https://github.com/brianrob) |
+| 2018 | [Rolling self-contained .NET Core app deployments forward to the latest patch](accepted/2018/self-contained-roll-forward.md) | [Daniel Plaisted](https://github.com/dsplaisted) |
+| 2018 | [Standardized Environment Variables for CI Services](accepted/2018/build/standard-ci-env-variables.md) | [Tomáš Matoušek](https://github.com/tmat) |
+| 2018 | [Windows Compatibility Pack](accepted/2018/compat-pack/compat-pack.md) | [Immo Landwerth](https://github.com/terrajobst), [Wes Haggard](https://github.com/weshaggard) |
+| 2019 | [.NET Core GC Support for Docker Limits](accepted/2019/support-for-memory-limits.md) | [Rich Lander](https://github.com/richlander) |
+| 2019 | [Background](accepted/2019/targeting-packs-and-runtime-packs.md) | [Rich Lander](https://github.com/richlander), [Nick Guerrera](https://github.com/nguerrera) |
+| 2019 | [Runtime Binding Behavior](accepted/2019/runtime-binding.md) | [Rich Lander](https://github.com/richlander) |
+| 2019 | [System.Index and System.Range](accepted/2019/system-range/system-range.md) | [Immo Landwerth](https://github.com/terrajobst) |
+| 2020 | [.NET 5 Minimum OS Versioning](accepted/2020/minimum-os-version/minimum-os-version.md) | [Mikayla Hutchinson](https://github.com/mhutch) |
+| 2020 | [.NET Core 3.0 AppDomain Replacement Design and Guidance](accepted/2020/AssemblyLoadContext/AppDomainReplacement.md) | [Steve MacLean](https://github.com/sdmaclea) |
+| 2020 | [.NET Optional SDK Workloads](accepted/2020/workloads/workloads.md) | [Rich Lander](https://github.com/richlander) |
+| 2020 | [.NET Runtime Form Factors](accepted/2020/form-factors.md) | [Rich Lander](https://github.com/richlander), [Jan Kotas](https://github.com/jkotas) |
+| 2020 | [.NET SDK Workload Manifests](accepted/2020/workloads/workload-manifest.md) | [Rich Lander](https://github.com/richlander) |
+| 2020 | [ASN.1 BER/CER/DER Reader & Writer](accepted/2020/asnreader/asnreader.md) | [Jeremy Barton](https://github.com/bartonjs) |
+| 2020 | [Annotating APIs as unsupported on specific platforms](accepted/2020/platform-exclusion/platform-exclusion.md) | [Immo Landwerth](https://github.com/terrajobst) |
+| 2020 | [Annotating platform-specific APIs and detecting its use](accepted/2020/platform-checks/platform-checks.md) | [Immo Landwerth](https://github.com/terrajobst) |
+| 2020 | [Better Obsoletion](accepted/2020/better-obsoletion/better-obsoletion.md) | [Immo Landwerth](https://github.com/terrajobst) |
+| 2020 | [BinaryFormatter Obsoletion Strategy](accepted/2020/better-obsoletion/binaryformatter-obsoletion.md) | [Levi Broderick](https://github.com/GrabYourPitchforks) |
+| 2020 | [CBOR Reader & Writer](accepted/2020/cbor/cbor.md) | [Eirik Tsarpalis](https://github.com/eiriktsarpalis) |
+| 2020 | [Easy Acquisition of .NET Framework Targeting Packs](accepted/2020/targeting-packs/targeting-packs.md) | [Immo Landwerth](https://github.com/terrajobst), [Daniel Plaisted](https://github.com/dsplaisted) |
+| 2020 | [Feature switch](accepted/2020/feature-switch.md) | [Vitek Karas](https://github.com/vitek-karas) |
+| 2020 | [Globalization Support in .NET 5](accepted/2020/mono-convergence/globalization-support-in-.net5.md) | [Steve Pfister](https://github.com/steveisok) |
+| 2020 | [Improve Activity API usability and OpenTelemetry integration](accepted/2020/diagnostics/activity-improvements.md) | [Sourabh Shirhatti](https://github.com/shirhatti), [Ankit Srivastava](https://github.com/ankit-oss) [Tarek Mahmoud Sayed](https://github.com/tarekgh) |
+| 2020 | [Improve Activity API usability and OpenTelemetry integration (Part 2)](accepted/2020/diagnostics/activity-improvements-2.md) | [Sourabh Shirhatti](https://github.com/shirhatti), [Tarek Mahmoud Sayed](https://github.com/tarekgh) |
+| 2020 | [Install location search for .NET Core](accepted/2020/install-locations.md) | [Vitek Karas](https://github.com/vitek-karas) |
+| 2020 | [JSON extension methods for HttpClient](accepted/2020/json-http-extensions/json-http-extensions.md) | [Immo Landwerth](https://github.com/terrajobst) |
+| 2020 | [Linking the .NET Libraries](accepted/2020/linking-libraries.md) | [Eric Erhardt](https://github.com/eerhardt) |
+| 2020 | [MSBuild SDK Resolvers and optional workloads in .NET 5](accepted/2020/workloads/workload-resolvers.md) | [Rich Lander](https://github.com/richlander) |
+| 2020 | [Marking APIs that are unsupported by Blazor WebAssembly](accepted/2020/blazor-unsupported-apis/blazor-unsupported-apis.md) | [Immo Landwerth](https://github.com/terrajobst) |
+| 2020 | [Marking Windows-only APIs](accepted/2020/windows-specific-apis/windows-specific-apis.md) | [Immo Landwerth](https://github.com/terrajobst) |
+| 2020 | [OR_GREATER preprocessor symbols for TFMs](accepted/2020/or-greater-defines/or-greater-defines.md) | [Immo Landwerth](https://github.com/terrajobst) |
+| 2020 | [Obsoletions in .NET 5](accepted/2020/better-obsoletion/obsoletions-in-net5.md) | [Immo Landwerth](https://github.com/terrajobst) |
+| 2020 | [Overview and goals](accepted/2020/serializer/SerializerGoals5.0.md) | [Steve Harter](https://github.com/steveharter) |
+| 2020 | [Platform Specific HttpClient Support in dotnet/runtime](accepted/2020/mono-convergence/platform-specific-httpclient.md) | [Steve Pfister](https://github.com/steveisok) |
+| 2020 | [Portable PDB](accepted/2020/diagnostics/portable-pdb.md) | [Tomáš Matoušek](https://github.com/tmat) |
+| 2020 | [Proposal for global.json](accepted/2020/global-json-updates.md) | [Kathleen Dollard](https://github.com/KathleenDollard) |
+| 2020 | [Publishing and Consuming Symbols and Source for Debugging](accepted/2020/diagnostics/debugging-with-symbols-and-sources.md) | [Tomáš Matoušek](https://github.com/tmat) |
+| 2020 | [Reproducible Build Validation](accepted/2020/reproducible-builds.md) | [Claire Novotny](https://github.com/clairernovotny), [Jared Parsons](https://github.com/jaredpar) |
+| 2020 | [Single-file Publish](accepted/2020/single-file/design.md) | [Swaroop Sridhar](https://github.com/swaroop-sridhar) |
+| 2020 | [Single-file Publish for .NET Core 3.0](accepted/2020/single-file/design_3_0.md) | [Swaroop Sridhar](https://github.com/swaroop-sridhar) |
+| 2020 | [Source Link](accepted/2020/diagnostics/source-link.md) | [Tomáš Matoušek](https://github.com/tmat) |
+| 2020 | [Target Framework Names in .NET 5](accepted/2020/net5/net5.md) | [Immo Landwerth](https://github.com/terrajobst) |
+| 2020 | [Type for holding & converting binary data](accepted/2020/binary-data/binary-data.md) | [Immo Landwerth](https://github.com/terrajobst) |
+| 2021 | [.NET 6.0 Target Frameworks](accepted/2021/net6.0-tfms/net6.0-tfms.md) | [Immo Landwerth](https://github.com/terrajobst) |
+| 2021 | [Designs](accepted/2021/statics-in-interfaces/designs/README.md) | [Immo Landwerth](https://github.com/terrajobst) |
+| 2021 | [Requirements](accepted/2021/statics-in-interfaces/requirements/README.md) | [Immo Landwerth](https://github.com/terrajobst) |
+| 2021 | [Scenarios](accepted/2021/statics-in-interfaces/scenarios/README.md) | [Immo Landwerth](https://github.com/terrajobst) |
+| 2021 | [Statics in Interfaces](accepted/2021/statics-in-interfaces/README.md) | [Immo Landwerth](https://github.com/terrajobst) |
+
+# Proposed
+
+| Design Name | Owner |
+| ----------- | ----- |
+| [Flexible HTTP APIs](proposed/flexible-http.md) | [Cory Nelson](https://github.com/scalablecory), [Geoff Kizer](https://github.com/geoffkizer) |
+| [Readonly references in C# and IL verification.](proposed/verifiable-ref-readonly.md) |  |
+| [Ref returns in C# and IL verification.](proposed/verifiable-ref-returns.md) |  |

README.md

@@ -1,7 +1,7 @@
 # .NET Design Proposals
 
-This repo contains [design proposals](meta/proposals.md) for the .NET platform.
-It focuses on designs for the runtime, framework, and the SDK. For others, see:
+This repo contains [design proposals](meta/proposals.md) for the .NET platform. For a complete listing, see [INDEX.md](INDEX.md).
+This repo focuses on designs for the runtime, framework, and the SDK. For others, see:
 
 * [C# Language Designs and Suggestions (dotnet/csharplang)](https://github.com/dotnet/csharplang)
 * [VB Language Designs and Suggestions (dotnet/vblang)](https://github.com/dotnet/vblang)

accepted/2018/build/standard-ci-env-variables.md

@@ -1,5 +1,7 @@
 # Standardized Environment Variables for CI Services
 
+**Dev** [Tomáš Matoušek](https://github.com/tmat)
+
 The .NET Core SDK is implementing new scenarios that require source control manager information. We want to make it very easy to embed repo-specific information in built assets as a means of creating a strong relationship between binary and source.
 
 To make it possible to provide application platform provided experiences across CI services, we need a standardized set of environment variables that are supported across those same CI services. Ideally, this set of environment variables would be supported across multiple CI services and useful for multiple application environments, not just .NET.

accepted/2018/cli-syntax-guideline.md

@@ -1,5 +1,7 @@
 # CLI Syntax Guidelines
 
+**PM** [Kathleen Dollard](https://github.com/KathleenDollard)
+
 Many tools have a CLI (command-line interface) which allows users to type English words to describe commands. This post describes how we build the syntax for commands in the .NET Core CLI. This articulates the guidelines that are similar to behavior of other CLIs, including Git (git), Angular (ng) and Azure (az).
 
 These guidelines were adopted as a goal for the CLI during .NET Core SDK 2.1.300 development. This version implements these goals for new features. Future SDKs will bring CLI syntax in line with these guidelines, while allowing existing syntax for backwards compatibility.

accepted/2018/cross-platform-performance-monitoring.md

@@ -1,4 +1,6 @@
-# Cross-Platform Performance Monitoring Design #
+# Cross-Platform Performance Monitoring Design
+
+**Dev** [Brian Robbins](https://github.com/brianrob)
 
 ### Introduction ###
 
@@ -63,4 +65,4 @@ Consumption of tracing data, including aggregated counter data, will be done via
 	- CONSIDER: Make EventSource pass a strongly typed object representing the payload fields.
 - Extra Credit: Move the LTTng implementation behind the EventPipe
 	- Right now, calls to LTTng sit right next to the EventPipe.  They should be moved behind the EventPipe just like ETW (above).
-	- This isn't specifically required for performance counters, but can/should be done especially if it cleans up the code or makes things easier.
+	- This isn't specifically required for performance counters, but can/should be done especially if it cleans up the code or makes things easier.

accepted/2018/file-enumeration.md

@@ -1,6 +1,7 @@
 # Extensible File Enumeration
 
-**PM** [Immo Landwerth](https://github.com/terrajobst) | **Dev** [Jeremy Kuhne](https://github.com/jeremykuhne)
+**PM** [Immo Landwerth](https://github.com/terrajobst) |
+**Dev** [Jeremy Kuhne](https://github.com/jeremykuhne)
 
 Enumerating files in .NET provides limited configurability. You can specify a simple DOS style pattern and whether or not to look recursively. More complicated filtering requires post filtering all results which can introduce a significant performance drain.
 
@@ -453,4 +454,4 @@ namespace System.IO
 }
 ```
 
-These routes would require adding some overhead to check for the "mock" data on every property call. Perf impact would need to be measured.
+These routes would require adding some overhead to check for the "mock" data on every property call. Perf impact would need to be measured.

accepted/2018/performance-profiling-controller.md

@@ -1,5 +1,7 @@
 # Performance Profiling Controller Design #
 
+**Dev** [Brian Robbins](https://github.com/brianrob)
+
 ### Introduction ###
 
 This document describes the end-to-end scenarios and work required to build a performance profiling controller for .NET Core.  The controller is responsible for control of the profiling infrastructure and exposure of performance data produced by .NET performance diagnostics components in a simple and cross-platform way.

accepted/2018/platform-intrinsics.md

@@ -1,5 +1,7 @@
 # .NET Platform Dependent Intrinsics
 
+**Dev** [Russell Hadley](https://github.com/russellhadley)
+
 ## Introduction
 The dotnet ecosystem supports many platforms and hardware architectures, and
 through its runtime implementation, ensuring that any MSIL has reasonable

accepted/2018/sdk-version-scheme.md

@@ -1,5 +1,7 @@
 # .NET Core SDK Versioning
 
+**PM** [Kathleen Dollard](https://github.com/KathleenDollard)
+
 .NET Core runtimes and SDKs are used together. They release independently, so it has been a challenge picking sensible version numbers. Going forward, the first and second positions of the version number will match for the Runtime and SDK. The third position will not match since the Runtime and SDK release independently.
 
 The Runtime will follow [semantic versioning](https://semver.org/). The first, second and third positions of the Runtime version number will correspond to major, minor and patch versions, respectively.
@@ -87,4 +89,4 @@ Behavior when SDK versions using both schemes are present:
 | 2.1.1                 | 2.1.3, 2.1.300 | 2.1.3 will run |
 | 2.1.1                 | 2.1.300        | error          |
 
-> Note: We will ship the updated SDK selection behavior with both .NET Core Runtime 2.1 and .NET Core SDK 2.1.300. This update in behavior is only important if your global.json includes a version that is 2.1.0 or higher and that SDK version is not present. From the release of .NET Core SDK 2.1.100 until the release of .NET Core SDK 2.1.300, we recommend you ensure that any versions of the SDK referenced by global.json is present on the machine. This approach avoids selecting a higher feature version of the SDK than you probably expect given the version specified in global.json
+> Note: We will ship the updated SDK selection behavior with both .NET Core Runtime 2.1 and .NET Core SDK 2.1.300. This update in behavior is only important if your global.json includes a version that is 2.1.0 or higher and that SDK version is not present. From the release of .NET Core SDK 2.1.100 until the release of .NET Core SDK 2.1.300, we recommend you ensure that any versions of the SDK referenced by global.json is present on the machine. This approach avoids selecting a higher feature version of the SDK than you probably expect given the version specified in global.json

accepted/2018/self-contained-roll-forward.md

@@ -1,5 +1,7 @@
 # Rolling self-contained .NET Core app deployments forward to the latest patch
 
+**Dev** [Daniel Plaisted](https://github.com/dsplaisted)
+
 ## Goal
 
 Self-contained deployments of .NET Core apps should roll forward to the latest patch version of the .NET Core runtime.  Framework-dependent deployments should by default target the ".0" patch version of the .NET Core runtime, and will be rolled forward to the latest patch version available on the machine when they are run.
@@ -80,4 +82,4 @@ The difference is that the reference to `Microsoft.NETCore.App` is implicit, whi
 
 ## Notes
 
-- `publish --no-build` - For this to work, you will need to have built with the RID specified (ie `dotnet build -r {rid}`)
+- `publish --no-build` - For this to work, you will need to have built with the RID specified (ie `dotnet build -r {rid}`)

accepted/2019/runtime-binding.md

@@ -1,5 +1,7 @@
 # Runtime Binding Behavior
 
+**PM** [Rich Lander](https://github.com/richlander)
+
 [Framework-dependent](https://docs.microsoft.com/dotnet/core/deploying/#framework-dependent-deployments-fdd)  applications require a .NET Core host to find a compatible runtime from a central location. The behavior of runtime binding is critical for both application compatibility and runtime deployment convenience. [Self-contained](https://docs.microsoft.com/dotnet/core/deploying/#self-contained-deployments-scd) apps don't have this need, because there is only one runtime they will ever use.
 
 This document proposes a model that works for both apps and managed COM components/hosting.

accepted/2019/support-for-memory-limits.md

@@ -1,5 +1,7 @@
 # .NET Core GC Support for Docker Limits
 
+**PM** [Rich Lander](https://github.com/richlander)
+
 .NET Core has support for [control groups](https://en.wikipedia.org/wiki/Cgroups) (cgroups), which is the basis of [Docker limits](https://docs.docker.com/config/containers/resource_constraints/). We found that the algorithm we use to honor cgroups works well for larger memory size limits (for example, >500MB), but that it is not possible to configure a .NET Core application to run indefinitely at lower memory levels. This document proposes an approach to support low memory size limits, <100MB.
 
 Note: Windows has a concept similar to cgroups called [job objects](https://docs.microsoft.com/windows/desktop/ProcThread/job-objects). .NET Core should honor job objects in the same way as cgroups, as appropriate. This document will focus on cgroups throughout.

accepted/2019/targeting-packs-and-runtime-packs.md

@@ -1,5 +1,8 @@
 # Background
 
+**PM** [Rich Lander](https://github.com/richlander) |
+**Dev** [Nick Guerrera](https://github.com/nguerrera) |
+
 The objectives here are:
 
 1. Summarize the new approach of FrameworkReferences, targeting packs and runtime packs

accepted/2020/AssemblyLoadContext/AppDomainReplacement.md

@@ -1,5 +1,7 @@
 # .NET Core 3.0 AppDomain Replacement Design and Guidance
 
+**Dev** [Steve MacLean](https://github.com/sdmaclea)
+
 .NET Core chose to not fully support the `System.AppDomain` type as
 implemented in .NET Framework
 

accepted/2020/asnreader/asnreader.md

@@ -1,5 +1,6 @@
 #  ASN.1 BER/CER/DER Reader & Writer
-[Jeremy Barton](https://github.com/bartonjs)
+
+**Dev** [Jeremy Barton](https://github.com/bartonjs)
 
 ASN.1 (Abstract Syntax Notation One), defined by [ITU-T X.680](https://www.itu.int/rec/dologin_pub.asp?lang=e&id=T-REC-X.680-201508-I!!PDF-E&type=items),
 is a data modelling language used to describe objects used in cryptographic key transmission, X.509 public key certificates,

accepted/2020/better-obsoletion/binaryformatter-obsoletion.md

@@ -1,5 +1,7 @@
 # BinaryFormatter Obsoletion Strategy
 
+**Dev** [Levi Broderick](https://github.com/GrabYourPitchforks)
+
 This document applies to the following framework versions:
 
 * .NET 5.0+

accepted/2020/blazor-unsupported-apis/blazor-unsupported-apis.md

@@ -1,5 +1,7 @@
 # Marking APIs that are unsupported by Blazor WebAssembly
 
+**PM** [Immo Landwerth](https://github.com/terrajobst)
+
 As discussed in [dotnet/designs#143] we're adding an analyzer to detect usage of
 unsupported APIs. This analyzer requires a custom attribute applied to method,
 containing type, or assembly.
@@ -237,4 +239,4 @@ Once the Windows attribution is done, I'll update this PR again.
     - UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, object, int, bool)
     - UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, object, long, bool)
     - UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, object, TimeSpan, bool)
-    - UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, object, uint, bool)
+    - UnsafeRegisterWaitForSingleObject(WaitHandle, WaitOrTimerCallback, object, uint, bool)