diff --git a/docs/pages/example/mapbox-gl-rtl-text.js b/docs/pages/example/mapbox-gl-rtl-text.js
index 13dbe798703..71792d35d95 100644
--- a/docs/pages/example/mapbox-gl-rtl-text.js
+++ b/docs/pages/example/mapbox-gl-rtl-text.js
@@ -2,8 +2,8 @@
 title: Add support for right-to-left scripts
 description: >-
   Use the [mapbox-gl-rtl-text](https://github.com/mapbox/mapbox-gl-rtl-text)
-  plugin to support scripts that use right-to-left layout such as Arabic or
-  Hebrew. The Mapbox Studio style editor loads this plugin by default.
+  plugin to support the Arabic or
+  Hebrew languages, which are written right-to-left. Mapbox Studio loads this plugin by default.
 tags:
   - internationalization
 pathname: /mapbox-gl-js/example/mapbox-gl-rtl-text/
diff --git a/src/index.js b/src/index.js
index a62e4a556b7..f3250dba471 100644
--- a/src/index.js
+++ b/src/index.js
@@ -132,7 +132,7 @@ const exported = {
 
 /**
  * Sets the map's [RTL text plugin](https://www.mapbox.com/mapbox-gl-js/plugins/#mapbox-gl-rtl-text).
- * Necessary for supporting languages like Arabic and Hebrew that are written right-to-left.
+ * Necessary for supporting the Arabic and Hebrew languages, which are written right-to-left. Mapbox Studio loads this plugin by default.
  *
  * @function setRTLTextPlugin
  * @param {string} pluginURL URL pointing to the Mapbox RTL text plugin source.