# HG changeset patch
# User Denis Laxalde <denis.laxalde@logilab.fr>
# Date 1471350401 -7200
# Node ID b2eb66dfd9c6e378490eff971183267f3f1d2d23
# Parent  e1876845fa107e283ff8515a32d88b92d84fafa8
[doc] Document change of instances location in virtualenv installation

Closes #14789440.

diff -r e1876845fa10 -r b2eb66dfd9c6 doc/changes/3.23.rst
--- a/doc/changes/3.23.rst	Tue Aug 16 14:16:10 2016 +0200
+++ b/doc/changes/3.23.rst	Tue Aug 16 14:26:41 2016 +0200
@@ -62,4 +62,14 @@
   `logilab.common.testlib.TestCase`) is no longer available.
 
 
+Development
+-----------
+
+When installed within a virtualenv, CubicWeb will look for instances data as
+in ``user`` mode by default, that is in ``$HOME/etc/cubicweb.d``, as opposed
+to ``$VIRTUAL_ENV/etc/cubicweb.d`` previously. To restore this behavior,
+explicitly set ``CW_MODE`` to ``system``. Alternatively (and preferably), the
+``CW_INSTANCES_DIR`` environment variables may be used to specify instances
+data location.
+
 .. _subtests: https://docs.python.org/3/library/unittest.html#distinguishing-test-iterations-using-subtests