diff --git a/doc/STYLE_GUIDE.md b/doc/STYLE_GUIDE.md index 9784787428dbf1..f0221991b79be2 100644 --- a/doc/STYLE_GUIDE.md +++ b/doc/STYLE_GUIDE.md @@ -55,10 +55,15 @@ * OK: JavaScript, Google's V8 * NOT OK: Javascript, Google's v8 - * Use _Node.js_ and not _Node_, _NodeJS_, or similar variants. * When referring to the executable, _`node`_ is acceptable. +* Be direct. + * OK: The return value is a string. + + * NOT OK: It is important to note that, in all cases, the return value will be + a string regardless. + See also API documentation structure overview in [doctools README][].