From eb2e31ea2d3f9aff6f3d6121777d7b200bffb3e1 Mon Sep 17 00:00:00 2001 From: Rich Trott Date: Sun, 14 Jun 2020 22:51:06 -0700 Subject: [PATCH] doc: standardize on sentence case for headers Previously, our documentation headers were a mixture of title case, sentence case, and things that were neither. For technical documentation, the _de facto_ standard seems to be sentence case. (See refs below.) So let's standardize on that. This commit follows a commit implementing this standard. This commit adds it to the style guide. Refs: https://developers.google.com/style/capitalization#capitalization-in-titles-and-headings Refs: https://docs.microsoft.com/en-us/style-guide/capitalization PR-URL: https://github.com/nodejs/node/pull/33889 Reviewed-By: Luigi Pinca Reviewed-By: James M Snell --- doc/guides/doc-style-guide.md | 3 +++ 1 file changed, 3 insertions(+) diff --git a/doc/guides/doc-style-guide.md b/doc/guides/doc-style-guide.md index 2e8acf02546763..59d9d493b770c6 100644 --- a/doc/guides/doc-style-guide.md +++ b/doc/guides/doc-style-guide.md @@ -68,6 +68,9 @@ * OK: _Node.js 14.x_, _Node.js 14.3.1_ * NOT OK: _Node.js v14_ +* For headings, use sentence case, not title case. + * OK: _## Everybody to the limit_ + * NOT OK: _## Everybody To The Limit_ See also API documentation structure overview in [doctools README][].