HSEARCH-1494 &  HSEARCH-1092

Addresses the above issues.

It introduces `IndexedEmbedded#includeEmbeddedObjectId` as flag to explicitly control the embedded object id. If the id is explicitly listed via `includePaths` it still gets included. I think this approach had so far most support.

What is not addressed yet, is whether the default for the `IndexedEmbedded#depth` parameter should change to 0. However, this should probably be addressed in a separate issue anyways.


This sentence

    In <<example-indexing-associations>> the aim is 

is readable in sources, but when rendered if becomes (including capital):

    In Indexing associations the aim is

which becomes confusing as the example title looks like the concept.
I think it would read better as

    In the example <<example-indexing-associations>> the aim is