feat: Initial Proposal for Diagnostic Feature Codes in OpenFeature

src/OpenFeature.DependencyInjection/Diagnostics/FeatureCodes.cs

@@ -0,0 +1,39 @@
+namespace OpenFeature.DependencyInjection.Diagnostics;
+
+/// <summary>
+/// Contains identifiers for experimental features and diagnostics in the OpenFeature framework.
+/// </summary>
+/// <remarks>
+/// <c>Experimental</c> - This class includes identifiers that allow developers to track and conditionally enable
+/// experimental features. Each identifier follows a structured code format to indicate the feature domain,
+/// maturity level, and unique identifier. Note that experimental features are subject to change or removal 
+/// in future releases.
+/// <para>
+/// <strong>Basic Information</strong><br/>
+/// These identifiers conform to OpenFeature’s Diagnostics Specifications, allowing developers to recognize 
+/// and manage experimental features effectively. For more details, refer to the 
+/// <a href="https://github.com/open-feature/dotnet-sdk/docs/diagnostics/README.md">Diagnostics Specifications</a>.
+/// </para>
+/// </remarks>
+/// <example>
+/// <code>
+/// Code Structure:
+///     - "OF" - Represents the OpenFeature library.
+///     - "DI" - Indicates the Dependency Injection domain.
+///     - "001" - Unique identifier for a specific feature.
+/// </code>
+/// </example>
+internal static class FeatureCodes
+{
+    /// <summary>
+    /// Identifier for the experimental Dependency Injection features within the OpenFeature framework.
+    /// </summary>
+    /// <remarks>
+    /// <c>OFDI001</c> identifier marks experimental features in the Dependency Injection (DI) domain.
+    /// 
+    /// Usage:
+    /// Developers can use this identifier to conditionally enable or test experimental DI features.
+    /// It is part of the OpenFeature diagnostics system to help track experimental functionality.
+    /// </remarks>
+    public const string NewDi = "OFDI001";
+}

src/OpenFeature.DependencyInjection/IFeatureProviderFactory.cs

@@ -5,6 +5,9 @@ namespace OpenFeature.DependencyInjection;
 /// This factory interface enables custom configuration and initialization of feature providers 
 /// to support domain-specific or application-specific feature flag management.
 /// </summary>
+#if NET8_0_OR_GREATER
+[System.Diagnostics.CodeAnalysis.Experimental(Diagnostics.FeatureCodes.NewDi)]
+#endif
 public interface IFeatureProviderFactory
 {
     /// <summary>

src/OpenFeature.DependencyInjection/OpenFeatureBuilderExtensions.cs

@@ -9,6 +9,9 @@ namespace OpenFeature;
 /// <summary>
 /// Contains extension methods for the <see cref="OpenFeatureBuilder"/> class.
 /// </summary>
+#if NET8_0_OR_GREATER
+[System.Diagnostics.CodeAnalysis.Experimental(DependencyInjection.Diagnostics.FeatureCodes.NewDi)]
+#endif
 public static partial class OpenFeatureBuilderExtensions
 {
     /// <summary>

src/OpenFeature.DependencyInjection/Providers/Memory/FeatureBuilderExtensions.cs

@@ -5,6 +5,9 @@ namespace OpenFeature.DependencyInjection.Providers.Memory;
 /// <summary>
 /// Extension methods for configuring feature providers with <see cref="OpenFeatureBuilder"/>.
 /// </summary>
+#if NET8_0_OR_GREATER
+[System.Diagnostics.CodeAnalysis.Experimental(Diagnostics.FeatureCodes.NewDi)]
+#endif
 public static partial class FeatureBuilderExtensions
 {
     /// <summary>

src/OpenFeature.DependencyInjection/Providers/Memory/InMemoryProviderFactory.cs

@@ -8,6 +8,9 @@ namespace OpenFeature.DependencyInjection.Providers.Memory;
 /// This factory allows for the customization of feature flags to facilitate 
 /// testing and lightweight feature flag management without external dependencies.
 /// </summary>
+#if NET8_0_OR_GREATER
+[System.Diagnostics.CodeAnalysis.Experimental(Diagnostics.FeatureCodes.NewDi)]
+#endif
 public class InMemoryProviderFactory : IFeatureProviderFactory
 {
     /// <summary>

test/OpenFeature.DependencyInjection.Tests/NoOpFeatureProviderFactory.cs

@@ -1,5 +1,8 @@
 namespace OpenFeature.DependencyInjection.Tests;
 
+#if NET8_0_OR_GREATER
+[System.Diagnostics.CodeAnalysis.Experimental(Diagnostics.FeatureCodes.NewDi)]
+#endif
 public class NoOpFeatureProviderFactory : IFeatureProviderFactory
 {
     public FeatureProvider Create() => new NoOpFeatureProvider();

test/OpenFeature.DependencyInjection.Tests/OpenFeatureBuilderExtensionsTests.cs

@@ -58,6 +58,9 @@ public void AddContext_Delegate_ShouldCorrectlyHandles(bool useServiceProviderDe
         delegateCalled.Should().BeTrue("The delegate should be invoked.");
     }
 
+    #if NET8_0_OR_GREATER
+    [System.Diagnostics.CodeAnalysis.Experimental(Diagnostics.FeatureCodes.NewDi)]
+    #endif
     [Fact]
     public void AddProvider_ShouldAddProviderToCollection()
     {
@@ -73,6 +76,9 @@ public void AddProvider_ShouldAddProviderToCollection()
             "A singleton service of type FeatureProvider should be added.");
     }
 
+    #if NET8_0_OR_GREATER
+    [System.Diagnostics.CodeAnalysis.Experimental(Diagnostics.FeatureCodes.NewDi)]
+    #endif
     [Fact]
     public void AddProvider_ShouldResolveCorrectProvider()
     {