From 723a72f6d6fdb0c79b41afb29661f1b176da09e0 Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Thu, 18 Jan 2024 08:18:43 -0800 Subject: [PATCH] Content strategy bug fix 2024-01-17 (#48743) --- .../style-guide.md | 24 ++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/content/contributing/style-guide-and-content-model/style-guide.md b/content/contributing/style-guide-and-content-model/style-guide.md index bd5440546d91..1e8acee16b0b 100644 --- a/content/contributing/style-guide-and-content-model/style-guide.md +++ b/content/contributing/style-guide-and-content-model/style-guide.md @@ -254,7 +254,29 @@ Note that regardless of the identifier you use (letters, words), footnotes will Headers must adequately describe the content under them. Headers can either follow the guidelines for writing titles or can be written as questions. Use sentence casing for headers. Each header on a page must be unique. -Use H2 for headers and H3 for subheaders. If an article has headers, the headers must start with an H2 level header and cannot skip header levels. There must be text content between a header and subheader, such as an introduction. When referring to headers, surround the header name with quotation marks. +If an article has headers, the headers must start with an H2 level header. You can use H3 and H4 level headers to further organize content into related groups, but you cannot skip header levels. There must be text content between a header and subheader, such as an introduction. +- **Use:** + + ```markdown + ## HEADER (H2) + TEXT + + ### SUBHEADER (H3) + TEXT + + #### SUBHEADER (H4) + TEXT + ``` + +- **Avoid:** + + ```markdown + ## HEADER (H2) + + #### SUBHEADER (H4) + ``` + +When referring to headers, surround the header name with quotation marks. - **Use:** Under "User licenses," view your total licenses. For more information, see the "[AUTOTITLE](/contributing/style-guide-and-content-model/contents-of-a-github-docs-article)."