chore: added some comments around the bespoke bits.

samples/SampleApp/SampleApp.Host/Interfaces/Services/IWeatherServiceTelemetry.cs

@@ -6,6 +6,15 @@
 
 namespace SampleApp.Host.Interfaces.Services;
 
+/* 
+ * A multi-target interface that defines
+ * the telemetry methods for the WeatherService, including
+ * Activities, Events, Logs, and Metrics.
+ * 
+ * As it's multi-target, each target needs to be
+ * explicitly defined.
+*/
+
 [ActivitySource]
 [Logger]
 [Meter]

samples/SampleApp/SampleApp.Host/Program.cs

@@ -10,6 +10,10 @@ public static void Main(string[] args) {
 		builder.Services.AddMetrics();
 
 		// Add services to the container.
+
+		// This is a generated method that adds the
+		// IWeatherServiceTelemetry interface to the container
+		// as a singleton.
 		builder.Services.AddIWeatherServiceTelemetry();
 		builder.Services.AddTransient<IWeatherService, WeatherService>();
 

samples/SampleApp/SampleApp.Host/Properties/AssemblyInfo.cs

@@ -1,3 +1,4 @@
 using Purview.Telemetry.Activities;
 
+// Default activity source name for the application.
 [assembly: ActivitySourceGeneration("sample-weather-app")]

samples/SampleApp/SampleApp.ServiceDefaults/Extensions.cs

@@ -41,7 +41,7 @@ public static IHostApplicationBuilder ConfigureOpenTelemetry(this IHostApplicati
 					   .AddProcessInstrumentation()
 					   .AddRuntimeInstrumentation()
 					   .AddMeter([
-						   "WeatherServiceTelemetry"
+						   "WeatherServiceTelemetry" // This is the name of the meter
 						 ]);
 			})
 			.WithTracing(tracing => {
@@ -54,7 +54,7 @@ public static IHostApplicationBuilder ConfigureOpenTelemetry(this IHostApplicati
 					   .AddGrpcClientInstrumentation()
 					   .AddHttpClientInstrumentation()
 					   .AddSource([
-							"sample-weather-app"
+							"sample-weather-app" // This is the name of the activity source
 						])
 				 ;
 			});