From 4d66633d78d99f60046ca9a67c486d24d74780fb Mon Sep 17 00:00:00 2001
From: Nimisha Asthagiri <nasthagiri@edx.org>
Date: Sun, 28 Apr 2019 18:48:30 -0400
Subject: [PATCH] testing.rst: update regarding acceptance tests

---
 docs/testing/testing.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/testing/testing.rst b/docs/testing/testing.rst
index ebf299dc34..7c6890557a 100644
--- a/docs/testing/testing.rst
+++ b/docs/testing/testing.rst
@@ -71,7 +71,8 @@ Integration Tests
 UI Acceptance Tests
 ~~~~~~~~~~~~~~~~~~~
 
--  Use these to test that major program features are working correctly.
+-  There should be very few UI acceptance tests since they are generally slow and
+   flaky. Use these to test only bare minimum happy paths for necessary features.
 
 -  We use `Bok Choy`_ to write end-user acceptance tests directly in Python,
    using the framework to maximize reliability and maintainability.