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.


They are very much related to the issue. I only updated the indexed embedded relevant section. I don't see at all why I should split the commits. Also I did not first change only the 'includeEmbeddedObjectId' relevant sentences and then changes other stuff. I reviewed and updated the section as a whole.