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