--- a/hgext3rd/evolve/__init__.py	Thu Jul 06 23:33:28 2017 +0200
+++ b/hgext3rd/evolve/__init__.py	Fri Jul 07 01:01:01 2017 +0200
@@ -77,6 +77,11 @@
   # (recommended 'yes' for server (default))
   obshashrange.warm-cache = no
 
+The initial cache warming is currently a bit slow. To make sure it is build you
+can run the following commands in your repository::
+
+    $ hg debugobshashrange --rev 'head()
+
 It is recommended to enable the blackbox extension. It gathers useful data about
 the experiment. It is shipped with Mercurial so no extra install is needed::
 
@@ -96,10 +101,12 @@
     # ensuring no large repository will get affected.
     obshashrange.max-revs = 100000 # default is None
 
-The initial cache warming is currently a bit slow. To make sure it is build you
-can run the following commands in your repository::
-
-    $ hg debugobshashrange --rev 'head()
+For very large repositories. it is currently recommended to disable obsmarkers
+discovery (Make sure you follow release announcement to know when you can turn
+it back on).
+
+    [experimental]
+    evolution.obsdiscovery = no
 
 Effect Flag Experiment
 ======================