diff --git a/include/json/reader.h b/include/json/reader.h
index 68b3738..d2bd140 100644
--- a/include/json/reader.h
+++ b/include/json/reader.h
@@ -277,6 +277,8 @@ public:
 
 /** \brief Build a CharReader implementation.
 
+  \deprecated This is experimental and will be altered before the next release.
+
 Usage:
 \code
   using namespace Json;
diff --git a/include/json/writer.h b/include/json/writer.h
index 5dffbe0..e81c245 100644
--- a/include/json/writer.h
+++ b/include/json/writer.h
@@ -75,6 +75,8 @@ std::string writeString(Value const& root, StreamWriter::Factory const& factory)
 
 /** \brief Build a StreamWriter implementation.
 
+  \deprecated This is experimental and will be altered before the next release.
+
 Usage:
 \code
   using namespace Json;