From eb2878caa84edf4c0602fb4d843cde90c79e953c Mon Sep 17 00:00:00 2001 From: Julian Cable Date: Thu, 18 Jan 2024 12:01:00 +0000 Subject: [PATCH] Clarify capitalization for table titles --- en-US/Cross_references.xml | 2 +- en-US/Design.xml | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/en-US/Cross_references.xml b/en-US/Cross_references.xml index aba9f6b..623cb63 100644 --- a/en-US/Cross_references.xml +++ b/en-US/Cross_references.xml @@ -29,7 +29,7 @@ Does the paragraph or section consist largely of links? - In running text, each paragraph should contain no more than a couple of links. Links should not occur in every paragraph, and they must not occur in titles, subheadings, figure captions, or table captions. Cross-references interrupt the flow of thought, and can actively interfere with the absorption of information. If the reader needs much extra information, rethink the structure of the section, and enrich the quality of the information. Do not let the cross-references overpower the message. A solution is to add a sentence to the end of the section to indicate where to find more information. + In running text, each paragraph should contain no more than a couple of links. Links should not occur in every paragraph, and they must not occur in titles, subheadings, or figure captions. Cross-references interrupt the flow of thought, and can actively interfere with the absorption of information. If the reader needs much extra information, rethink the structure of the section, and enrich the quality of the information. Do not let the cross-references overpower the message. A solution is to add a sentence to the end of the section to indicate where to find more information. diff --git a/en-US/Design.xml b/en-US/Design.xml index b772694..38c4e17 100644 --- a/en-US/Design.xml +++ b/en-US/Design.xml @@ -16,7 +16,7 @@ Capitalization The standard for all Red Hat technical documentation is title case for all headings and titles. - Table headings and procedure headings fall under this heading; standard title case capitalization rules apply. + Table titles and procedure headings fall into this category; standard title case capitalization rules apply. @@ -26,7 +26,7 @@ The currently accepted reference for determining title case is at https://titlecase.com/titlecase. - Use sentence case for captions, legends, diagram labels, and table column headers. + Use sentence case for figure captions, legends, diagram labels, and table column headers. They are not classified as titles.