From 066c9a15cfc0a37111ae615ce57b44f7de3b6b1e Mon Sep 17 00:00:00 2001
From: David Tolnay <dtolnay@gmail.com>
Date: Fri, 3 Feb 2017 07:43:04 -0800
Subject: [PATCH] Explain status of content module

---
 serde/src/de/content.rs | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/serde/src/de/content.rs b/serde/src/de/content.rs
index 292d6a44..fa8875c8 100644
--- a/serde/src/de/content.rs
+++ b/serde/src/de/content.rs
@@ -1,3 +1,15 @@
+// This module is doc(hidden) and nothing here should be used outside of
+// generated code.
+//
+// We will iterate on the implementation for a few releases and only have to
+// worry about backward compatibility for the `untagged` and `tag` attributes
+// rather than for this entire mechanism.
+//
+// This issue is tracking making some of this stuff public:
+// https://github.com/serde-rs/serde/issues/741
+
+#![doc(hidden)]
+
 use core::fmt;
 use core::marker::PhantomData;
 
@@ -22,7 +34,6 @@ use de::{
 /// deserializing untagged enums and internally tagged enums.
 ///
 /// Not public API. Use serde-value instead.
-#[allow(missing_docs)]
 #[derive(Debug)]
 pub enum Content<E> {
     // Don't mind the PhantomData, just need to use E somewhere.