From 9b155a3126ac2b4f3e57fb27d853581a15896f8f Mon Sep 17 00:00:00 2001
From: "J. Nick Koston" <nick@home-assistant.io>
Date: Wed, 21 Jan 2026 12:50:39 -1000
Subject: [PATCH] document document document

---
 esphome/components/http_request/http_request.h | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/esphome/components/http_request/http_request.h b/esphome/components/http_request/http_request.h
index 30e205bf106..cd683e8d759 100644
--- a/esphome/components/http_request/http_request.h
+++ b/esphome/components/http_request/http_request.h
@@ -378,6 +378,8 @@ template<typename... Ts> class HttpRequestSendAction : public Action<Ts...> {
       RAMAllocator<uint8_t> allocator;
       uint8_t *buf = allocator.allocate(max_length);
       if (buf != nullptr) {
+        // NOTE: HttpContainer::read() has non-BSD socket semantics - see top of this file
+        // Use http_read_loop_result() helper instead of checking return values directly
         size_t read_index = 0;
         uint32_t last_data_time = millis();
         const uint32_t read_timeout = this->parent_->get_timeout();