diff --git a/airbyte-webapp/src/hooks/services/Experiment/experiments.ts b/airbyte-webapp/src/hooks/services/Experiment/experiments.ts
index afbc1d57e990..9bb39f541302 100644
--- a/airbyte-webapp/src/hooks/services/Experiment/experiments.ts
+++ b/airbyte-webapp/src/hooks/services/Experiment/experiments.ts
@@ -1,5 +1,7 @@
 /* eslint sort-keys: "error" */
 /**
+ * Experiments are short-term flags for A/B testing or staged rollouts of features.
+ *
  * When adding a new feature flag in LaunchDarkly to consume in code you'll need to make
  * sure to update the typing here.
  */
diff --git a/airbyte-webapp/src/hooks/services/Feature/types.tsx b/airbyte-webapp/src/hooks/services/Feature/types.tsx
index a7a252416f69..af4ce8c61921 100644
--- a/airbyte-webapp/src/hooks/services/Feature/types.tsx
+++ b/airbyte-webapp/src/hooks/services/Feature/types.tsx
@@ -1,3 +1,8 @@
+/**
+ * FeatureItems are for permanent flags to differentiate features between environments (e.g. Cloud vs. OSS),
+ * workspaces, specific user groups, etc.
+ */
+
 export enum FeatureItem {
   AllowUploadCustomImage = "ALLOW_UPLOAD_CUSTOM_IMAGE",
   AllowCustomDBT = "ALLOW_CUSTOM_DBT",