diff --git a/core/modules/simpletest/src/BrowserTestBase.php b/core/modules/simpletest/src/BrowserTestBase.php
index e531b65..7565d33 100644
--- a/core/modules/simpletest/src/BrowserTestBase.php
+++ b/core/modules/simpletest/src/BrowserTestBase.php
@@ -31,6 +31,10 @@
 /**
  * Test case for functional Drupal tests.
  *
+ * Currently this class should only be used for JavaScript testing, for
+ * everything else, WebTestBase is better for now. This is likely to change
+ * after Drupal 8.0
+ *
  * @ingroup testing
  *
  * All BrowserTestBase tests must have two annotations to ensure process