diff --git a/include/clap/ext/state.h b/include/clap/ext/state.h
index 0166fd8d..8d028e1b 100644
--- a/include/clap/ext/state.h
+++ b/include/clap/ext/state.h
@@ -10,16 +10,6 @@
 /// values and non-parameter state. This is used to persist a plugin's state
 /// between project reloads, when duplicating and copying plugin instances, and
 /// for host-side preset management.
-///
-/// ## Notes on using streams
-///
-/// When working with `clap_istream` and `clap_ostream` objects to load and save
-/// state, it is important to keep in mind that the host may limit the number of
-/// bytes that can be read or written at a time. The return values for the
-/// stream read and write functions indicate how many bytes were actually read
-/// or written. You need to use a loop to ensure that you read or write the
-/// entirety of your state. Don't forget to also consider the negative return
-/// values for the end of file and IO error codes.
 
 static CLAP_CONSTEXPR const char CLAP_EXT_STATE[] = "clap.state";
 
diff --git a/include/clap/stream.h b/include/clap/stream.h
index 3e8d9a91..b9b0b6cf 100644
--- a/include/clap/stream.h
+++ b/include/clap/stream.h
@@ -3,6 +3,18 @@
 #include "private/std.h"
 #include "private/macros.h"
 
+/// @page Streams
+///
+/// ## Notes on using streams
+///
+/// When working with `clap_istream` and `clap_ostream` objects to load and save
+/// state, it is important to keep in mind that the host may limit the number of
+/// bytes that can be read or written at a time. The return values for the
+/// stream read and write functions indicate how many bytes were actually read
+/// or written. You need to use a loop to ensure that you read or write the
+/// entirety of your state. Don't forget to also consider the negative return
+/// values for the end of file and IO error codes.
+
 #ifdef __cplusplus
 extern "C" {
 #endif