diff --git a/include/mbedtls/net_sockets.h b/include/mbedtls/net_sockets.h
index 7a0148b..6bcd920 100644
--- a/include/mbedtls/net_sockets.h
+++ b/include/mbedtls/net_sockets.h
@@ -280,16 +280,24 @@
                              uint32_t timeout);
 
 /**
- * \brief          Close down the connection and clear the context
+ * \brief          Closes down the connection and free associated data
  *
  * \param ctx      The context to close
+ *
+ * \note           This function frees and clears data associated with the
+ *                 context but does not free the memory pointed to by \p ctx.
+ *                 This memory is the responsibility of the caller.
  */
 void mbedtls_net_close(mbedtls_net_context *ctx);
 
 /**
- * \brief          Gracefully shutdown the connection and clear the context
+ * \brief          Gracefully shutdown the connection and free associated data
  *
- * \param ctx      The context to gracefully shutdown
+ * \param ctx      The context to free
+ *
+ * \note           This function frees and clears data associated with the
+ *                 context but does not free the memory pointed to by \p ctx.
+ *                 This memory is the responsibility of the caller.
  */
 void mbedtls_net_free(mbedtls_net_context *ctx);