diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..e625780
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,54 @@
+*.py[cod]
+
+# C extensions
+*.so
+
+# Packages
+*.egg
+*.egg-info
+dist
+build
+.eggs
+eggs
+parts
+bin
+var
+sdist
+develop-eggs
+.installed.cfg
+lib
+lib64
+
+# Installer logs
+pip-log.txt
+
+# Unit test / coverage reports
+.coverage
+.tox
+nosetests.xml
+.testrepository
+.venv
+
+# Translations
+*.mo
+
+# Mr Developer
+.mr.developer.cfg
+.project
+.pydevproject
+
+# Complexity
+output/*.html
+output/*/index.html
+
+# Sphinx
+doc/build
+
+# pbr generates these
+AUTHORS
+ChangeLog
+
+# Editors
+*~
+.*.swp
+.*sw?
diff --git a/README.rst b/README.rst
index 7ba5c33..18e3763 100644
--- a/README.rst
+++ b/README.rst
@@ -5,3 +5,11 @@
 Tempest Plugin for Horizon tests
 
 * Free software: Apache license
+
+Using
+--------
+Install this plugin in the same python environment as tempest.
+
+In tempest directory, run::
+
+  testr run tempest_horizon.tests.scenario.test_dashboard_basic_ops.TestDashboardBasicOps