Index: src/site/apt/1.11/examples.apt
===================================================================
--- src/site/apt/1.11/examples.apt	(revision 1721078)
+++ src/site/apt/1.11/examples.apt	(working copy)
@@ -51,7 +51,34 @@
 
 %{include|source=src/examples-src/main/java/org/apache/tika/example/ParsingExample.java|snippet=aj:..parseExample()|show-gutter=false}
 
+~~ Examples should be included in the 1.12 version of the site
 
+** {Parsing using the Recursive Parser Wrapper}
+   
+   When you want to parse embedded documents, you can extract content from both the enclosing
+   document and all embedded ones by passing the parser into the 
+   {{{./api/org/apache/tika/parser/ParseContext.html}ParseContext}}
+   instance.
+
+%{include|source=src/examples-src/main/java/org/apache/tika/example/ParsingExample.java|snippet=aj:..parseEmbeddedExample()|show-gutter=false}
+
+   Alternatively, you can use the 
+   {{{./api/org/apache/tika/parser/RecursiveParserWrapper.html}RecursiveParserWrapper}}, 
+   which handles passing the parser into 
+   {{{./api/org/apache/tika/parser/ParseContext.html}ParseContext}}. 
+   This wrapper class returns a list of 
+   {{{./api/org/apache/tika/metadata/Metadata.html}Metadata}} 
+   objects, where the first element is the metadata and content for the container document, and the rest for each embedded document.
+
+%{include|source=src/examples-src/main/java/org/apache/tika/example/ParsingExample.java|snippet=aj:..recursiveParserWrapperExample()|show-gutter=false}
+   
+   The 
+   {{{./api/org/apache/tika/metadata/serialization/JsonMetadataList.html}JsonMetadataList}} 
+   class can serialize the metadata list into JSON, and deserialize back into the list.
+
+
+%{include|source=src/examples-src/main/java/org/apache/tika/example/ParsingExample.java|snippet=aj:..serializedRecursiveParserWrapperExample()|show-gutter=false}
+
 * {Picking different output formats}
 
    With Tika, you can get the textual content of your files returned