update

Author: HeartLinked

src/iceberg/catalog/rest/request_types.h

@@ -30,6 +30,10 @@
 #include "iceberg/sort_order.h"
 #include "iceberg/table_identifier.h"
 
+/// \file iceberg/catalog/rest/request_types.h
+/// Defines all request body structures for the Iceberg REST Catalog API,
+/// corresponding to the JSON payloads sent to various /v1 endpoints.
+
 namespace iceberg::rest {
 
 /// \brief Request to create a namespace.

src/iceberg/catalog/rest/response_types.h

@@ -28,6 +28,11 @@
 #include "iceberg/table_identifier.h"
 #include "iceberg/table_metadata.h"
 
+/// \file iceberg/catalog/rest/response_types.h
+/// Defines all response body structures for the Iceberg REST Catalog API,
+/// representing the JSON results returned by /v1 endpoints (excluding HTTP headers like
+/// ETag).
+
 namespace iceberg::rest {
 
 /// \brief An opaque token that allows clients to make use of pagination for list APIs.