diff --git a/doc/api.rst b/doc/api.rst
index 6fa11c48..ee781a7e 100644
--- a/doc/api.rst
+++ b/doc/api.rst
@@ -273,6 +273,9 @@ Utilities
 
 .. doxygenfunction:: fmt::join(It, It, string_view)
 
+.. doxygenclass:: fmt::detail::buffer
+   :members:
+
 .. doxygenclass:: fmt::basic_memory_buffer
    :protected-members:
    :members:
diff --git a/include/fmt/core.h b/include/fmt/core.h
index 65850e5e..e5d94c5e 100644
--- a/include/fmt/core.h
+++ b/include/fmt/core.h
@@ -627,7 +627,12 @@ using has_formatter =
 
 namespace detail {
 
-/** A contiguous memory buffer with an optional growing ability. */
+/**
+  \rst
+  A contiguous memory buffer with an optional growing ability. It is an internal
+  class and shouldn't be used directly, only via `~fmt::basic_memory_buffer`.
+  \endrst
+ */
 template <typename T> class buffer {
  private:
   T* ptr_;