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.


That's one of the big dislikes I have with asciidoctor. I don't like how it renders links to other sections and examples. There docbook was much better. Instead of just rendering the title of the thing you are referring to, it should be eg 'Example xyx, bla bla'. I talked to @mojavelinux  and he promised me to come back with a solution.

I also don't like the global numbering of examples. They should be per chapter. 

I guess for now I change the wording. However, I would assume there are more than this one spot we have to fix this. In the end the whole documentation needs a full review before the final Search 5 release.