DATAMONGO-1245 - Update documentation.

Author: mp911de

src/main/asciidoc/index.adoc

@@ -1,5 +1,5 @@
 = Spring Data MongoDB - Reference Documentation
-Mark Pollack; Thomas Risberg; Oliver Gierke; Costin Leau; Jon Brisbin; Thomas Darimont; Christoph Strobl
+Mark Pollack; Thomas Risberg; Oliver Gierke; Costin Leau; Jon Brisbin; Thomas Darimont; Christoph Strobl; Mark Paluch
 :revnumber: {version}
 :revdate: {localdate}
 :toc:
@@ -27,8 +27,6 @@ include::{spring-data-commons-docs}/repositories.adoc[]
 include::reference/introduction.adoc[]
 include::reference/mongodb.adoc[]
 include::reference/mongo-repositories.adoc[]
-include::{spring-data-commons-docs}/query-by-example.adoc[]
-include::reference/query-by-example.adoc[]
 include::{spring-data-commons-docs}/auditing.adoc[]
 include::reference/mongo-auditing.adoc[]
 include::reference/mapping.adoc[]

src/main/asciidoc/reference/mongodb.adoc

@@ -1330,6 +1330,10 @@ TextQuery.searching(new TextCriteria().matching("\"coffee cake\""));
 TextQuery.searching(new TextCriteria().phrase("coffee cake"));
 ----
 
+include::../{spring-data-commons-docs}/query-by-example.adoc[]
+include::query-by-example.adoc[]
+
+
 [[mongo.mapreduce]]
 == Map-Reduce Operations
 

src/main/asciidoc/reference/query-by-example.adoc

@@ -1,5 +1,5 @@
 [[query.by.example.execution]]
-== Executing Query by Example
+=== Executing Example
 
 In Spring Data MongoDB you can use Query by Example with the `MongoTemplate` and with Repositories.
 
@@ -17,7 +17,7 @@ public class PersonService {
 ----
 ====
 
-`MongoTemplate.findByExample` accepts either the probe or an `Example` object to create and execute a query.
+`MongoTemplate.findByExample` accepts either the probe or an `Example` object to create and execute a query. An `Example` containing an untyped `ExampleSpec` uses the probe type to determine the collection name and the result type. Typed `ExampleSpec` use their type to determine collection name and result type.
 
 
 .Query by Example using a Repository
@@ -39,6 +39,8 @@ public class PersonService {
 ----
 ====
 
+An `Example` containing an untyped `ExampleSpec` uses the Repository type and its collection name. Typed `ExampleSpec` use their type as result type and the collection name from the Repository.
+
 NOTE: When including `null` values in the `ExampleSpec` Spring Data Mongo uses embedded document matching instead of dot notation property matching. This forces exact document matching for all property values and the property order in the embedded document.
 
 Spring Data MongoDB provides support for the following matching options: