docs(webapp): add JSDoc to overridable trigger/otel variable resolvers

Author: ThullyoCunha

apps/webapp/app/v3/environmentVariables/environmentVariablesRepository.server.ts

@@ -941,6 +941,13 @@ function renameVariables(variables: EnvironmentVariable[], renameMap: Record<str
   });
 }
 
+/**
+ * Resolves trigger-side built-in environment variables that are merged into a
+ * task run's env but can be overridden by user-defined variables on the
+ * environment. Values come from server-level `env` and are surfaced to runners
+ * so they can pick up rollouts (e.g. the realtime stream version) without a
+ * redeploy.
+ */
 async function resolveOverridableTriggerVariables(
   runtimeEnvironment: RuntimeEnvironmentForEnvRepo
 ) {
@@ -1088,6 +1095,12 @@ async function resolveBuiltInDevVariables(runtimeEnvironment: RuntimeEnvironment
   return [...result, ...commonVariables];
 }
 
+/**
+ * Resolves the OpenTelemetry collector endpoint advertised to dev (CLI) task
+ * runs. Defaults to the webapp's own `/otel` route under `APP_ORIGIN` so a
+ * vanilla self-host works without extra wiring; `DEV_OTEL_EXPORTER_OTLP_ENDPOINT`
+ * can override it to point spans/logs at an external collector.
+ */
 async function resolveOverridableOtelDevVariables(
   runtimeEnvironment: RuntimeEnvironmentForEnvRepo
 ) {