diff --git a/core/core.api.php b/core/core.api.php
index 3059bf4..fec1e55 100644
--- a/core/core.api.php
+++ b/core/core.api.php
@@ -1143,15 +1143,15 @@
  *   environment, so it can only rely on the setUp() method, not what has
  *   been set up by other test methods.
  *
- * @section write_jsfunctional_phpunit Write javascript tests
- * Quite some functionality relies on Javascript. In order to allow
- * people to write functional test coverage for those Drupal provides another
- * base class, \Drupal\FunctionalJavascriptTests\JavascriptTestBase, which works
- * really similar to BrowserTestBase.
+ * @section write_jsfunctional_phpunit Write JavaScript tests
+ * A lot of functionality relies on JavaScript. In order to allow people to
+ * provide functional test coverage for those Drupal provides another base
+ * class, \Drupal\FunctionalJavaScriptTests\JavascriptTestBase, which works
+ * really similar to BrowserTestBase, exists.
  * - You need to put the tests into tests/src/FunctionalJavascript and use
  *   the Drupal\Tests\$module\FunctionalJavascript namespace
- * - You need to run phantomjs, see core/tests/README.md
- * - You use the same assertions as BrowserTestBase
+ * - You need to run phantomjs, see core/tests/README.md.
+ * - You use the same assertions as BrowserTestBase.
  * - When clicking a link/button with ajax behaviour, you need to keep in mind
  *   that the underlying browser might need a while to deliver changes to the
  *   HTML, which is why we provide