diff --git a/sdk/core/azure-core/inc/azure/core/http/curl_transport.hpp b/sdk/core/azure-core/inc/azure/core/http/curl_transport.hpp
index 3cb14c3f1..e02bd6491 100644
--- a/sdk/core/azure-core/inc/azure/core/http/curl_transport.hpp
+++ b/sdk/core/azure-core/inc/azure/core/http/curl_transport.hpp
@@ -120,6 +120,8 @@ namespace Azure { namespace Core { namespace Http {
      * @remark The default is the built-in system specific path. More about this option:
      * https://curl.se/libcurl/c/CURLOPT_CAINFO.html
      *
+     * @remark This option is known to only work on Linux and might throw if set on other platforms.
+     *
      */
     std::string CAInfo;