Add context clarification comments to interface method code snippets (#47683)

* Initial plan

* Add context clarification comments to interface method snippets

Co-authored-by: BillWagner <[email protected]>

* Fix code comments to end with periods per style guide

Co-authored-by: gewarren <[email protected]>

---------

Co-authored-by: copilot-swe-agent[bot] <[email protected]>
Co-authored-by: BillWagner <[email protected]>
Co-authored-by: gewarren <[email protected]>

Author: 3 people

docs/csharp/advanced-topics/interface-implementation/snippets/default-interface-members-versions/finished/customer-relationship/ICustomer.cs

@@ -11,6 +11,7 @@ public interface ICustomer
 
     /*
     // <SnippetLoyaltyDiscountVersionOne>
+    // This method belongs in the ICustomer interface (ICustomer.cs).
     // Version 1:
     public decimal ComputeLoyaltyDiscount()
     {
@@ -26,6 +27,7 @@ public decimal ComputeLoyaltyDiscount()
 
     /*
     // <SnippetLoyaltyDiscountVersionTwo>
+    // These methods belong in the ICustomer interface (ICustomer.cs).
     // Version 2:
     public static void SetLoyaltyThresholds(
         TimeSpan ago,
@@ -65,6 +67,7 @@ public static void SetLoyaltyThresholds(TimeSpan ago, int minimumOrders, decimal
     private static decimal discountPercent = 0.10m;
 
     // <SnippetFinalVersion>
+    // These methods belong in the ICustomer interface (ICustomer.cs).
     public decimal ComputeLoyaltyDiscount() => DefaultLoyaltyDiscount(this);
     protected static decimal DefaultLoyaltyDiscount(ICustomer c)
     {

docs/csharp/advanced-topics/interface-implementation/snippets/default-interface-members-versions/finished/customer-relationship/SampleCustomer.cs

@@ -26,6 +26,7 @@ public void AddOrder(IOrder order)
     }
 
     // <SnippetOverrideAndExtend>
+    // This method belongs in the SampleCustomer class (SampleCustomer.cs) that implements ICustomer.
     public decimal ComputeLoyaltyDiscount()
     {
        if (PreviousOrders.Any() == false)