diff --git a/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md b/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md index ed23d72fa11a4ea..f6fb88dd8572e4a 100644 --- a/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md +++ b/files/en-us/mdn/writing_guidelines/writing_style_guide/index.md @@ -253,6 +253,21 @@ Some examples include: - JavaScript (a trademark of Oracle Corporation, it should always be written as trademarked) - Python, TypeScript, Django, and other programming languages and framework names +Certain tools or projects have their own branded capitalization. There are three types: + +1. **Lowercase**: The name is always lowercase, such as "npm" or "webpack" (see an exception below). +2. **Uppercase**: The name is always uppercase, such as "UNIX", "GNOME", or "VIM". +3. **Mixed case**: The name has a mix of cases, such as "TypeScript", "macOS", or "jQuery". + +Always use official capitalization since self-representation is more important than formal language rules. If you are unsure, check the official website or documentation. + +The only exception is when the always-lowercase name is at the beginning of a sentence. In this case, use a sentence case. For example: + +- Webpack is a module bundler you can install using npm. +- Npm can be used to install the webpack module bundler. + +The reason for this exception is to help readers to find the beginning of sentences more easily. + ### Contractions Our writing style tends to be casual, so you should feel free to use contractions (e.g., "don't", "can't", "shouldn't"), if you prefer.