diff --git a/src/libcamera/stream.cpp b/src/libcamera/stream.cpp
index 85cd5256ee2f..5839b983f45f 100644
--- a/src/libcamera/stream.cpp
+++ b/src/libcamera/stream.cpp
@@ -194,4 +194,21 @@ Stream::Stream()
  * \return The active configuration of the stream
  */
 
+/**
+ * \var Stream::bufferPool_
+ * \brief The pool of buffers associated with the stream
+ *
+ * The stream buffer pool is populated by the Camera class after a succesfull
+ * stream configuration.
+ */
+
+/**
+ * \var Stream::configuration_
+ * \brief The configuration associated with the stream
+ *
+ * The stream configuration is accessible only to Stream sub-classes and to
+ * the Camera class, that associates the Stream with the configuration returned
+ * by a succesfull PipelineHandler::configureStreams() call.
+ */
+
 } /* namespace libcamera */