diff --git a/best-practices/README.md b/best-practices/README.md
index 785159e3..840c8f69 100644
--- a/best-practices/README.md
+++ b/best-practices/README.md
@@ -336,8 +336,8 @@ Ruby JSON APIs
 * Follow Heroku's [HTTP API Design Guide]
 * Use a fast JSON parser, e.g. [`oj`][oj]
 * Write integration tests for your API endpoints. When the primary consumer of
-  your API is an in-app JavaScript client, write [feature specs]. Otherwise
-  write [request specs].
+  the API is a JavaScript client maintained within the same code base as the
+  provider of the API, write [feature specs]. Otherwise write [request specs].
 
 [HTTP API Design Guide]: https://github.com/interagent/http-api-design
 [oj]: https://github.com/ohler55/oj