From 7de2b2276fe6dc783dff45e8ec703e7df785e04b Mon Sep 17 00:00:00 2001
From: Graham Esau <gesau@hotmail.co.uk>
Date: Thu, 25 Mar 2021 22:15:12 +0000
Subject: [PATCH] Prepare to update docs for `schema_for_value!`

---
 docs/3-generating.md | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/docs/3-generating.md b/docs/3-generating.md
index 29222f0..cc65004 100644
--- a/docs/3-generating.md
+++ b/docs/3-generating.md
@@ -20,8 +20,16 @@ If you want more control over how the schema is generated, you can use the [`gen
 
 See the API documentation for more info on how to use those types for custom schema generation.
 
+<!-- UNCOMMMENT FOR 0.8.2:
+## Schema from Example Values
+
+If you want a schema for a type that can't/doesn't implement `JsonSchema`, but does implement `serde::Serialize`, then you can generate a JSON schema from a value of that type using the [`schema_for_value!` macro](https://docs.rs/schemars/latest/schemars/macro.schema_for_value.html). However, this schema will generally be less precise than if the type implemented `JsonSchema` - particularly when it involves enums, since schemars will not make any assumptions about the structure of an enum based on a single variant.
+
+```rust
+let value = MyStruct { foo = 123 };
+let my_schema = schema_for_value!(value);
+``` -->
+
 <!-- TODO:
 create and link to example
-
-Generating schema from example value
 -->