1 files changed, 10 insertions, 1 deletions
diff --git a/src/core/lib/channel/context.h b/src/core/lib/channel/context.h
index c50e84279d..22f4cb62f3 100644
--- a/src/core/lib/channel/context.h
+++ b/src/core/lib/channel/context.h
@@ -34,10 +34,19 @@
 #ifndef GRPC_CORE_LIB_CHANNEL_CONTEXT_H
 #define GRPC_CORE_LIB_CHANNEL_CONTEXT_H
 
-/* Call object context pointers */
+// Call object context pointers.
+
+// Call context is represented as an array of grpc_call_context_elements.
+// This enum represents the indexes into the array, where each index
+// contains a different type of value.
 typedef enum {
+  // Value is either a grpc_client_security_context or a
+  // grpc_server_security_context.
   GRPC_CONTEXT_SECURITY = 0,
+
+  // Value is a census_context.
   GRPC_CONTEXT_TRACING,
+
   GRPC_CONTEXT_COUNT
 } grpc_context_index;