comments fix

Author: Krish

include/aws/http/http.h

@@ -123,9 +123,10 @@ void aws_http_library_init(struct aws_allocator *alloc);
 AWS_HTTP_API
 void aws_http_library_clean_up(void);
 
-/**
- * Helper used downstream to check if the HTTP error codes can be classified
- * as transient errors.
+/*
+ * This API provides a recommendation on whether an error code should be considered retryable for transient
+ * errors like host resolution, sockets, and TLS.
+ * Note: This is a recommendation only. Retry behavior should be determined based on your specific use case.
  */
 AWS_HTTP_API
 bool aws_http_error_code_is_retryable(int error_code);

source/http.c

@@ -556,6 +556,9 @@ void aws_http_fatal_assert_library_initialized(void) {
     }
 }
 
+/*
+ * This might need to get updated with more http error codes based on consensus.
+ */
 bool aws_http_error_code_is_retryable(int error_code) {
     switch (error_code) {
         case AWS_ERROR_HTTP_CONNECTION_CLOSED: