Add instruction to run fullstack test locally

Change-Id: I308a47a30c55dbe991fffe42ba681f57cf2cee44

doc/source/fullstack-test.rst

@@ -0,0 +1,50 @@
+==========================
+Run fullstack test locally
+==========================
+
+This is a guide for developers who want to run fullstack tests in their local
+machine.
+
+Prerequisite
+============
+
+You need to deploy Fuxi in a devstack environment.
+
+Clone devstack::
+
+    # Create a root directory for devstack if needed
+    sudo mkdir -p /opt/stack
+    sudo chown $USER /opt/stack
+
+    git clone https://git.openstack.org/openstack-dev/devstack /opt/stack/devstack
+
+We will run devstack with minimal local.conf settings required. You can use the
+sample local.conf as a quick-start::
+
+    git clone https://git.openstack.org/openstack/fuxi /opt/stack/fuxi
+    cp /opt/stack/fuxi/devstack/local.conf.sample /opt/stack/devstack/local.conf
+
+Run devstack::
+
+    cd /opt/stack/devstack
+    ./stack.sh
+
+**NOTE:** This will take a while to setup the dev environment.
+
+Preparation
+===========
+
+Navigate to fuxi directory::
+
+    cd /opt/stack/fuxi
+
+Source the credential of 'fuxi' user::
+
+    source /opt/stack/devstack/openrc fuxi service
+
+Run the test
+============
+
+Run this command::
+
+    tox -efullstack

doc/source/index.rst

@@ -15,7 +15,8 @@ Contents:
    installation
    usage
    contributing
-   reno.rst
+   reno
+   fullstack-test
 
 Indices and tables
 ==================