{"id":202,"date":"2020-07-24T18:00:22","date_gmt":"2020-07-24T18:00:22","guid":{"rendered":"https:\/\/courses.lumenlearning.com\/suny-esc-technicalwriting\/?post_type=chapter&#038;p=202"},"modified":"2020-11-13T14:58:56","modified_gmt":"2020-11-13T14:58:56","slug":"headings","status":"publish","type":"chapter","link":"https:\/\/courses.lumenlearning.com\/suny-esc-technicalwriting\/chapter\/headings\/","title":{"raw":"Headings","rendered":"Headings"},"content":{"raw":"<img class=\"size-medium wp-image-1462 alignright\" src=\"https:\/\/s3-us-west-2.amazonaws.com\/courses-images\/wp-content\/uploads\/sites\/5366\/2020\/07\/22130609\/136-300x185.jpg\" alt=\"\" width=\"300\" height=\"185\" \/>\r\n\r\nHeadings are very useful in technical writing. They:\r\n<ul>\r\n \t<li>offer main concepts succinctly<\/li>\r\n \t<li>alert readers to upcoming topics and subtopics<\/li>\r\n \t<li>break up long stretches of text<\/li>\r\n \t<li>help readers locate specific information quickly<\/li>\r\n \t<li>make the text easy to navigate<\/li>\r\n<\/ul>\r\nAs a reader, look at the <a href=\"https:\/\/www.healthypeople.gov\/2020\/topics-objectives\/topic\/environmental-health\" target=\"_blank\" rel=\"noopener\">Environmental Health<\/a> page from the U.S. Department of Health and Human Services' Healthy People site. Headings make it easy to see the scope of information on the page, as well as locate a section of information that interests you. Headings make the page readable and accessible.\r\n\r\nHeadings are also useful to you as a writer. They keep you organized and focused on the topic. When you begin using headings, your impulse may be to create headings\u00a0after\u00a0you've written the rough draft. Instead, anticipate the headings\u00a0before\u00a0you start the rough draft, and use them to keep you on track as you write. If you outline your document, you can often extract headings from your outline, as headings are main ideas.\r\n\r\n<img class=\"resizable\" src=\"https:\/\/softchalkcloud.com\/lesson\/files\/ZEQwxjK8lbSPHW\/head_fig2.gif\" alt=\"Headings and outlines: headings function like outline elements inserted into the text at those points where they apply.\" width=\"609\" height=\"664\" \/>\r\n<h2>General Guidelines for Headings<\/h2>\r\nHeadings are so important that there are a number of guidelines that deal with heading content, level, language use, and conventions.\r\n<h3>Heading Content<\/h3>\r\n<ul>\r\n \t<li>Use headings to identify the major sections and subsections of a report.<\/li>\r\n \t<li>Make headings indicate the range of topic coverage in the section. For example, if the section covers the\u00a0design\u00a0and\u00a0operation\u00a0of a pressurized water reactor, the heading \"Pressurized Water Reactor Design\" would be incomplete and misleading, since it does not include the concept of operation.<\/li>\r\n<\/ul>\r\n<h3>Heading Level<\/h3>\r\n<ul>\r\n \t<li>Use a different style for each level of heading: main headings within the text (not the same as the title), second level, third level, etc. That does not always mean that you need to use different fonts; you can choose different sizes, colors, or capitalization. Apply each heading style consistently throughout the document.<\/li>\r\n \t<li>Consider \u201crun-in\u201d headings (words in bold or color that actually start a sentence) only if you have a lot of heading levels. Run-in headings can help you avoid the problem of too many lower-level headings looking alike.<\/li>\r\n \t<li>Use actual headings as much as possible instead of bold or italic text, for accessibility.<\/li>\r\n<\/ul>\r\n<h3>Heading Language<\/h3>\r\n<ul>\r\n \t<li>Use specific, self-explanatory language in headings. For example, instead of \"Background\" or \"Technical Information,\" use \"Physics of Fiber Optics.\"<\/li>\r\n \t<li>When possible, omit articles from the beginning of headings to be as concise as possible. For example, \"The Pressurized Water Reactor\" can easily be changed to \"Pressurized Water Reactors.\"<\/li>\r\n \t<li>Use parallel phrasing in the same level of heading, e.g., all -ing words, or all noun phrases.<\/li>\r\n<\/ul>\r\n<h3>Heading Conventions<\/h3>\r\n<ul>\r\n \t<li>Avoid stacked headings\u2014any two consecutive headings without intervening text.<\/li>\r\n \t<li>Avoid a lone heading by itself without another like it in the same section. If you don't have enough content for two headings, then you may not need a heading.<\/li>\r\n \t<li>Avoid \"widows and orphans\" in headings, when a heading occurs at the bottom of a column or page and the text it introduces starts at the top of the next column or page. Make sure to have at least two lines of text after the heading if the heading occurs toward the end of a page, or else put the heading and its text on a new page.<\/li>\r\n \t<li>Avoid pronoun reference to headings. For example, if you have a heading \"Torque,\" don't begin the sentence following it with something like \"This is a physics principle.....\" Don't assume that a reader will relate the pronoun \"this\" to the heading \"Torque.\"<\/li>\r\n \t<li>Don't use headings as titles for tables or figures.<\/li>\r\n<\/ul>\r\n<ul>\r\n \t<li>\u00a0A very general guideline for reports and longer documents is to have two-three headings per regular page of text. Note that this is a guideline only, but you get the idea that you should have a few sections and headings on most pages of text in longer documents, as opposed to either a block of text, or too many sections and headings.<\/li>\r\n<\/ul>\r\nCheck out the Purdue Online Writing Lab page on <a href=\"https:\/\/owl.purdue.edu\/owl\/research_and_citation\/apa_style\/apa_formatting_and_style_guide\/apa_headings_and_seriation.html\" target=\"_blank\" rel=\"noopener\">APA Headings and Seriation<\/a> for details and examples of headings in APA style.\r\n<figure><\/figure>\r\n<h2>Common Problems with Headings<\/h2>\r\nProblems occur with headings when they are too wordy, not parallel in language, not clearly representative of their information, or not comply with general heading guidelines in some way.\u00a0 The following diagram points out some common heading problems.\r\n<figure><\/figure>\r\n<figure><img class=\"resizable\" src=\"https:\/\/softchalkcloud.com\/lesson\/files\/ZEQwxjK8lbSPHW\/heading_prob2.jpg\" alt=\"Common problems with headings: picture these outline items in the actual text.\" width=\"947\" height=\"741\" \/><\/figure>\r\n<div class=\"textbox exercises\">\r\n<h3>try it<\/h3>\r\nTechnical writers themselves fall into errors with headings. Look at the page on <a href=\"https:\/\/courses.lumenlearning.com\/technicalwriting\/chapter\/memos_-purpose-and-format-2\/\" target=\"_blank\" rel=\"noopener\">Memos: Purpose and Format<\/a> in a Technical Writing text. See how many errors with headings you can identify, and explain how each error could be corrected.\r\n\r\n[reveal-answer q=\"1\"] Compare your Answer [\/reveal-answer]\r\n[hidden-answer a=\"1\"]\r\n<ol>\r\n \t<li>The first two headings are stacked - there is no text between the main heading \"Memos: Purpose and Format\" and the next heading \"Memos.\" There is no need for the \"Memos\" heading; correct the stacked headings by eliminating \"Memos.\"<\/li>\r\n \t<li>\"Five Tips for Effective Business Memos\" is a main heading. However, the main heading for the page indicates only two second-level headings, Purpose and Format. The \"Five Tips\" section does include a tip on format, but also includes a wider range of tips that deal with content and language. In this case, the main heading might be edited to be more inclusive, e.g., \"Writing Effective Memos.\" Then the page could logically include three second-level headings.<\/li>\r\n \t<li>There's another set of stacked headings with \"Five Tips\" and \"Audience Orientation.\" Insert some text here.<\/li>\r\n \t<li>The headings that come after \"Five Tips\" are visually at the same level as \"Five Tips,\" in the same size and bold blue type. Yet these headings (\"Audience Orientation,\" \"Professional Formal Tone,\" etc.) should be third-level headings, since they offer specific tips.\u00a0 Correct them by differentiating them in size and color.<\/li>\r\n<\/ol>\r\n[\/hidden-answer]\r\n\r\n<\/div>\r\n&nbsp;","rendered":"<p><img loading=\"lazy\" decoding=\"async\" class=\"size-medium wp-image-1462 alignright\" src=\"https:\/\/s3-us-west-2.amazonaws.com\/courses-images\/wp-content\/uploads\/sites\/5366\/2020\/07\/22130609\/136-300x185.jpg\" alt=\"\" width=\"300\" height=\"185\" \/><\/p>\n<p>Headings are very useful in technical writing. They:<\/p>\n<ul>\n<li>offer main concepts succinctly<\/li>\n<li>alert readers to upcoming topics and subtopics<\/li>\n<li>break up long stretches of text<\/li>\n<li>help readers locate specific information quickly<\/li>\n<li>make the text easy to navigate<\/li>\n<\/ul>\n<p>As a reader, look at the <a href=\"https:\/\/www.healthypeople.gov\/2020\/topics-objectives\/topic\/environmental-health\" target=\"_blank\" rel=\"noopener\">Environmental Health<\/a> page from the U.S. Department of Health and Human Services&#8217; Healthy People site. Headings make it easy to see the scope of information on the page, as well as locate a section of information that interests you. Headings make the page readable and accessible.<\/p>\n<p>Headings are also useful to you as a writer. They keep you organized and focused on the topic. When you begin using headings, your impulse may be to create headings\u00a0after\u00a0you&#8217;ve written the rough draft. Instead, anticipate the headings\u00a0before\u00a0you start the rough draft, and use them to keep you on track as you write. If you outline your document, you can often extract headings from your outline, as headings are main ideas.<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"resizable\" src=\"https:\/\/softchalkcloud.com\/lesson\/files\/ZEQwxjK8lbSPHW\/head_fig2.gif\" alt=\"Headings and outlines: headings function like outline elements inserted into the text at those points where they apply.\" width=\"609\" height=\"664\" \/><\/p>\n<h2>General Guidelines for Headings<\/h2>\n<p>Headings are so important that there are a number of guidelines that deal with heading content, level, language use, and conventions.<\/p>\n<h3>Heading Content<\/h3>\n<ul>\n<li>Use headings to identify the major sections and subsections of a report.<\/li>\n<li>Make headings indicate the range of topic coverage in the section. For example, if the section covers the\u00a0design\u00a0and\u00a0operation\u00a0of a pressurized water reactor, the heading &#8220;Pressurized Water Reactor Design&#8221; would be incomplete and misleading, since it does not include the concept of operation.<\/li>\n<\/ul>\n<h3>Heading Level<\/h3>\n<ul>\n<li>Use a different style for each level of heading: main headings within the text (not the same as the title), second level, third level, etc. That does not always mean that you need to use different fonts; you can choose different sizes, colors, or capitalization. Apply each heading style consistently throughout the document.<\/li>\n<li>Consider \u201crun-in\u201d headings (words in bold or color that actually start a sentence) only if you have a lot of heading levels. Run-in headings can help you avoid the problem of too many lower-level headings looking alike.<\/li>\n<li>Use actual headings as much as possible instead of bold or italic text, for accessibility.<\/li>\n<\/ul>\n<h3>Heading Language<\/h3>\n<ul>\n<li>Use specific, self-explanatory language in headings. For example, instead of &#8220;Background&#8221; or &#8220;Technical Information,&#8221; use &#8220;Physics of Fiber Optics.&#8221;<\/li>\n<li>When possible, omit articles from the beginning of headings to be as concise as possible. For example, &#8220;The Pressurized Water Reactor&#8221; can easily be changed to &#8220;Pressurized Water Reactors.&#8221;<\/li>\n<li>Use parallel phrasing in the same level of heading, e.g., all -ing words, or all noun phrases.<\/li>\n<\/ul>\n<h3>Heading Conventions<\/h3>\n<ul>\n<li>Avoid stacked headings\u2014any two consecutive headings without intervening text.<\/li>\n<li>Avoid a lone heading by itself without another like it in the same section. If you don&#8217;t have enough content for two headings, then you may not need a heading.<\/li>\n<li>Avoid &#8220;widows and orphans&#8221; in headings, when a heading occurs at the bottom of a column or page and the text it introduces starts at the top of the next column or page. Make sure to have at least two lines of text after the heading if the heading occurs toward the end of a page, or else put the heading and its text on a new page.<\/li>\n<li>Avoid pronoun reference to headings. For example, if you have a heading &#8220;Torque,&#8221; don&#8217;t begin the sentence following it with something like &#8220;This is a physics principle&#8230;..&#8221; Don&#8217;t assume that a reader will relate the pronoun &#8220;this&#8221; to the heading &#8220;Torque.&#8221;<\/li>\n<li>Don&#8217;t use headings as titles for tables or figures.<\/li>\n<\/ul>\n<ul>\n<li>\u00a0A very general guideline for reports and longer documents is to have two-three headings per regular page of text. Note that this is a guideline only, but you get the idea that you should have a few sections and headings on most pages of text in longer documents, as opposed to either a block of text, or too many sections and headings.<\/li>\n<\/ul>\n<p>Check out the Purdue Online Writing Lab page on <a href=\"https:\/\/owl.purdue.edu\/owl\/research_and_citation\/apa_style\/apa_formatting_and_style_guide\/apa_headings_and_seriation.html\" target=\"_blank\" rel=\"noopener\">APA Headings and Seriation<\/a> for details and examples of headings in APA style.<\/p>\n<figure><\/figure>\n<h2>Common Problems with Headings<\/h2>\n<p>Problems occur with headings when they are too wordy, not parallel in language, not clearly representative of their information, or not comply with general heading guidelines in some way.\u00a0 The following diagram points out some common heading problems.<\/p>\n<figure><\/figure>\n<figure><img loading=\"lazy\" decoding=\"async\" class=\"resizable\" src=\"https:\/\/softchalkcloud.com\/lesson\/files\/ZEQwxjK8lbSPHW\/heading_prob2.jpg\" alt=\"Common problems with headings: picture these outline items in the actual text.\" width=\"947\" height=\"741\" \/><\/figure>\n<div class=\"textbox exercises\">\n<h3>try it<\/h3>\n<p>Technical writers themselves fall into errors with headings. Look at the page on <a href=\"https:\/\/courses.lumenlearning.com\/technicalwriting\/chapter\/memos_-purpose-and-format-2\/\" target=\"_blank\" rel=\"noopener\">Memos: Purpose and Format<\/a> in a Technical Writing text. See how many errors with headings you can identify, and explain how each error could be corrected.<\/p>\n<div class=\"qa-wrapper\" style=\"display: block\"><span class=\"show-answer collapsed\" style=\"cursor: pointer\" data-target=\"q1\"> Compare your Answer <\/span><\/p>\n<div id=\"q1\" class=\"hidden-answer\" style=\"display: none\">\n<ol>\n<li>The first two headings are stacked &#8211; there is no text between the main heading &#8220;Memos: Purpose and Format&#8221; and the next heading &#8220;Memos.&#8221; There is no need for the &#8220;Memos&#8221; heading; correct the stacked headings by eliminating &#8220;Memos.&#8221;<\/li>\n<li>&#8220;Five Tips for Effective Business Memos&#8221; is a main heading. However, the main heading for the page indicates only two second-level headings, Purpose and Format. The &#8220;Five Tips&#8221; section does include a tip on format, but also includes a wider range of tips that deal with content and language. In this case, the main heading might be edited to be more inclusive, e.g., &#8220;Writing Effective Memos.&#8221; Then the page could logically include three second-level headings.<\/li>\n<li>There&#8217;s another set of stacked headings with &#8220;Five Tips&#8221; and &#8220;Audience Orientation.&#8221; Insert some text here.<\/li>\n<li>The headings that come after &#8220;Five Tips&#8221; are visually at the same level as &#8220;Five Tips,&#8221; in the same size and bold blue type. Yet these headings (&#8220;Audience Orientation,&#8221; &#8220;Professional Formal Tone,&#8221; etc.) should be third-level headings, since they offer specific tips.\u00a0 Correct them by differentiating them in size and color.<\/li>\n<\/ol>\n<\/div>\n<\/div>\n<\/div>\n<p>&nbsp;<\/p>\n\n\t\t\t <section class=\"citations-section\" role=\"contentinfo\">\n\t\t\t <h3>Candela Citations<\/h3>\n\t\t\t\t\t <div>\n\t\t\t\t\t\t <div id=\"citation-list-202\">\n\t\t\t\t\t\t\t <div class=\"licensing\"><div class=\"license-attribution-dropdown-subheading\">CC licensed content, Original<\/div><ul class=\"citation-list\"><li>Headings, adapted from Open Technical Communication; attributions below. <strong>Authored by<\/strong>: Susan Oaks. <strong>Provided by<\/strong>: Empire State College, SUNY. <strong>Project<\/strong>: Technical Writing. <strong>License<\/strong>: <em><a target=\"_blank\" rel=\"license\" href=\"https:\/\/creativecommons.org\/licenses\/by-nc\/4.0\/\">CC BY-NC: Attribution-NonCommercial<\/a><\/em><\/li><\/ul><div class=\"license-attribution-dropdown-subheading\">CC licensed content, Shared previously<\/div><ul class=\"citation-list\"><li>Headings (pages 1-4). <strong>Authored by<\/strong>: David McMurrey &amp; Cassandra Race. <strong>Provided by<\/strong>: Kennesaw State University. <strong>Located at<\/strong>: <a target=\"_blank\" href=\"https:\/\/softchalkcloud.com\/lesson\/serve\/ZEQwxjK8lbSPHW\/html\">https:\/\/softchalkcloud.com\/lesson\/serve\/ZEQwxjK8lbSPHW\/html<\/a>. <strong>Project<\/strong>: Open Technical Communication. <strong>License<\/strong>: <em><a target=\"_blank\" rel=\"license\" href=\"https:\/\/creativecommons.org\/licenses\/by\/4.0\/\">CC BY: Attribution<\/a><\/em><\/li><li>Page Design (page 2 of 6). <strong>Authored by<\/strong>: David McMurrey and Jonathan Arnett. <strong>Provided by<\/strong>: Kennesaw State University. <strong>Located at<\/strong>: <a target=\"_blank\" href=\"https:\/\/softchalkcloud.com\/lesson\/serve\/GZgMx1yw3kRhzL\/html\">https:\/\/softchalkcloud.com\/lesson\/serve\/GZgMx1yw3kRhzL\/html<\/a>. <strong>Project<\/strong>: Open Technical Communication. <strong>License<\/strong>: <em><a target=\"_blank\" rel=\"license\" href=\"https:\/\/creativecommons.org\/licenses\/by\/4.0\/\">CC BY: Attribution<\/a><\/em><\/li><li>image of file folders with tabs for headings. <strong>Authored by<\/strong>: Ulrike Mai . <strong>Provided by<\/strong>: Pixabay. <strong>Located at<\/strong>: <a target=\"_blank\" href=\"https:\/\/pixabay.com\/photos\/hanging-files-filing-cabinet-1920437\/\">https:\/\/pixabay.com\/photos\/hanging-files-filing-cabinet-1920437\/<\/a>. <strong>License<\/strong>: <em><a target=\"_blank\" rel=\"license\" href=\"https:\/\/creativecommons.org\/about\/cc0\">CC0: No Rights Reserved<\/a><\/em><\/li><\/ul><\/div>\n\t\t\t\t\t\t <\/div>\n\t\t\t\t\t <\/div>\n\t\t\t <\/section>","protected":false},"author":81366,"menu_order":3,"template":"","meta":{"_candela_citation":"[{\"type\":\"original\",\"description\":\"Headings, adapted from Open Technical Communication; attributions below\",\"author\":\"Susan Oaks\",\"organization\":\"Empire State College, SUNY\",\"url\":\"\",\"project\":\"Technical Writing\",\"license\":\"cc-by-nc\",\"license_terms\":\"\"},{\"type\":\"cc\",\"description\":\"Headings (pages 1-4)\",\"author\":\"David McMurrey & Cassandra Race\",\"organization\":\"Kennesaw State University\",\"url\":\"https:\/\/softchalkcloud.com\/lesson\/serve\/ZEQwxjK8lbSPHW\/html\",\"project\":\"Open Technical Communication\",\"license\":\"cc-by\",\"license_terms\":\"\"},{\"type\":\"cc\",\"description\":\"Page Design (page 2 of 6)\",\"author\":\"David McMurrey and Jonathan Arnett\",\"organization\":\"Kennesaw State University\",\"url\":\"https:\/\/softchalkcloud.com\/lesson\/serve\/GZgMx1yw3kRhzL\/html\",\"project\":\"Open Technical Communication\",\"license\":\"cc-by\",\"license_terms\":\"\"},{\"type\":\"cc\",\"description\":\"image of file folders with tabs for headings\",\"author\":\"Ulrike Mai \",\"organization\":\"Pixabay\",\"url\":\"https:\/\/pixabay.com\/photos\/hanging-files-filing-cabinet-1920437\/\",\"project\":\"\",\"license\":\"cc0\",\"license_terms\":\"\"}]","CANDELA_OUTCOMES_GUID":"","pb_show_title":"on","pb_short_title":"","pb_subtitle":"","pb_authors":[],"pb_section_license":""},"chapter-type":[],"contributor":[],"license":[],"class_list":["post-202","chapter","type-chapter","status-publish","hentry"],"part":193,"_links":{"self":[{"href":"https:\/\/courses.lumenlearning.com\/suny-esc-technicalwriting\/wp-json\/pressbooks\/v2\/chapters\/202","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/courses.lumenlearning.com\/suny-esc-technicalwriting\/wp-json\/pressbooks\/v2\/chapters"}],"about":[{"href":"https:\/\/courses.lumenlearning.com\/suny-esc-technicalwriting\/wp-json\/wp\/v2\/types\/chapter"}],"author":[{"embeddable":true,"href":"https:\/\/courses.lumenlearning.com\/suny-esc-technicalwriting\/wp-json\/wp\/v2\/users\/81366"}],"version-history":[{"count":14,"href":"https:\/\/courses.lumenlearning.com\/suny-esc-technicalwriting\/wp-json\/pressbooks\/v2\/chapters\/202\/revisions"}],"predecessor-version":[{"id":1678,"href":"https:\/\/courses.lumenlearning.com\/suny-esc-technicalwriting\/wp-json\/pressbooks\/v2\/chapters\/202\/revisions\/1678"}],"part":[{"href":"https:\/\/courses.lumenlearning.com\/suny-esc-technicalwriting\/wp-json\/pressbooks\/v2\/parts\/193"}],"metadata":[{"href":"https:\/\/courses.lumenlearning.com\/suny-esc-technicalwriting\/wp-json\/pressbooks\/v2\/chapters\/202\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/courses.lumenlearning.com\/suny-esc-technicalwriting\/wp-json\/wp\/v2\/media?parent=202"}],"wp:term":[{"taxonomy":"chapter-type","embeddable":true,"href":"https:\/\/courses.lumenlearning.com\/suny-esc-technicalwriting\/wp-json\/pressbooks\/v2\/chapter-type?post=202"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/courses.lumenlearning.com\/suny-esc-technicalwriting\/wp-json\/wp\/v2\/contributor?post=202"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/courses.lumenlearning.com\/suny-esc-technicalwriting\/wp-json\/wp\/v2\/license?post=202"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}