Simplify public headers more

src/commit_request.hpp

@@ -147,12 +147,22 @@ public:
 
   /**
    * @brief Get access to the underlying arena allocator for debugging.
+   *
+   * @note This function is primarily used for testing and debugging.
+   * Production code should prefer the specific accessor methods like
+   * total_allocated() and used_bytes() instead of direct arena access.
+   *
    * @return Reference to the arena allocator
    */
   const ArenaAllocator &arena() const { return arena_; }
 
   /**
    * @brief Get access to the underlying arena allocator for allocation.
+   *
+   * @note This function exposes the internal arena for direct manipulation.
+   * It should be used carefully and primarily for internal parser
+   * implementation or testing purposes.
+   *
    * @return Reference to the arena allocator
    */
   ArenaAllocator &arena() { return arena_; }