diff --git a/templates/gRPC.podspec.template b/templates/gRPC.podspec.template
index e396c411a68bc35b783d70b490e716f3a6615d47..3b96fe28857a56194d41c0bbc4841ab037fbe063 100644
--- a/templates/gRPC.podspec.template
+++ b/templates/gRPC.podspec.template
@@ -86,6 +86,8 @@
       ss.private_header_files = ${(',\n' + 30*' ').join('\'%s\'' % f for f in grpc_private_headers(libs))}
 
       ss.header_mappings_dir = '.'
+      # This isn't officially supported in Cocoapods. We've asked for an alternative:
+      # https://github.com/CocoaPods/CocoaPods/issues/4386
       ss.xcconfig = { 'HEADER_SEARCH_PATHS' => '"$(PODS_ROOT)/Headers/Private/gRPC" ' +
                                                '"$(PODS_ROOT)/Headers/Private/gRPC/include"' }