@@ -809,7 +809,10 @@ versionCtlParams cfg =
809-- | 'indexDocument' is the primary way to save a single document in
809-- | 'indexDocument' is the primary way to save a single document in
810-- Elasticsearch. The document itself is simply something we can
810-- Elasticsearch. The document itself is simply something we can
811-- convert into a JSON 'Value'. The 'DocId' will function as the
811-- convert into a JSON 'Value'. The 'DocId' will function as the
812−-- primary key for the document.
812+-- primary key for the document. You are encouraged to generate
813+-- your own id's and not rely on ElasticSearch's automatic id
814+-- generation. Read more about it here:
815+-- https://github.com/bitemyapp/bloodhound/issues/107
814-- >>> resp <- runBH' $ indexDocument testIndex testMapping defaultIndexDocumentSettings exampleTweet (DocId "1")
817-- >>> resp <- runBH' $ indexDocument testIndex testMapping defaultIndexDocumentSettings exampleTweet (DocId "1")
815-- >>> print resp
818-- >>> print resp