diff --git a/core/core.api.php b/core/core.api.php
index 61e5e3b..4427ee6 100644
--- a/core/core.api.php
+++ b/core/core.api.php
@@ -1133,7 +1133,7 @@
  *   migration process, the group core uses is migrate_drupal_6. Use yourmodule
  *   as the group name if the test does not belong to another larger group.
  * - You may also override the default setUp() method, which can be used to set
- *   up content types and similar procedures. Don't forget to invoke the parent
+ *   up content types and similar procedures. Don't forget to call the parent
  *   method.
  * - In some cases, you may need to write a test module to support your test;
  *   put such modules under the yourmodule/tests/modules directory.
@@ -1144,15 +1144,15 @@
  *   been set up by other test methods.
  *
  * @section write_jsfunctional_phpunit Write functional JavaScript tests (phpunit)
- * A lot of functionality relies on JavaScript. In order to allow people to
- * provide functional test coverage for this, Drupal provides the
- * JavascriptTestBase class, which works really similar to BrowserTestBase:
+ * A lot of functionality relies on JavaScript. To write a functional test that
+ * relies on JavaScript:
  * - Extend \Drupal\FunctionalJavaScriptTests\JavascriptTestBase.
- * - Place the test into yourmodule/tests/src/FunctionalJavascript and use
- *   the Drupal\Tests\yourmodule\FunctionalJavascript namespace
+ * - Place the test into the yourmodule/tests/src/FunctionalJavascript directory
+ *   and use the Drupal\Tests\yourmodule\FunctionalJavascript namespace.
  * - Add a @group annotation. Use yourmodule as the group name if the test does
  *   not belong to another larger group.
- * - To run JavaScript tests, set up PhantomJS, see core/tests/README.md.
+ * - Set up PhantomJS; see http://phantomjs.org/download.html.
+ * - To run tests, see core/tests/README.md.
  * - When clicking a link/button with Ajax behavior attached, you need to keep
  *   in mind that the underlying browser might need a while to deliver changes
  *   to the HTML. Use $this->assertSession()->assertWaitOnAjaxRequest() to wait