{"id":70,"date":"2023-05-11T12:12:28","date_gmt":"2023-05-11T12:12:28","guid":{"rendered":"https:\/\/courses.lumenlearning.com\/suny-technicalwriting\/chapter\/common-page-design\/"},"modified":"2023-05-17T16:00:35","modified_gmt":"2023-05-17T16:00:35","slug":"common-page-design","status":"publish","type":"chapter","link":"https:\/\/courses.lumenlearning.com\/suny-technicalwriting\/chapter\/common-page-design\/","title":{"raw":"Revising to Enhance Readability","rendered":"Revising to Enhance Readability"},"content":{"raw":"<div class=\"textbox learning-objectives\">\r\n<h3>Learning Objectives<\/h3>\r\n<ul>\r\n \t<li>Review a Revision Checklist<\/li>\r\n<\/ul>\r\n<\/div>\r\n<p class=\"textbox__title\">Anything that you write is designed to be read.\u00a0That is its first and foremost purpose. Thus, increasing readability means increasing the functionality of your document in terms of both content and document design\u2014making it \u201cuser friendly.\u201d If your document is difficult to read because vocabulary, sentence structure, paragraphing, organization, or formatting is unclear, your reader will likely stop reading.<\/p>\r\n<p class=\"textbox__title\">The\u00a0<strong>Revision Checklist<\/strong>\u00a0below offers a step-by-step process for revising your document to achieve a readable style.\u00a0Implementing this checklist means doing several \u201cpasses\u201d over your document, looking at different aspects each time. For example, in your \u201cfirst pass,\u201d review the entire document for overall formatting, content requirements, coherent flow of information, and appropriate tone.<\/p>\r\n\r\n<div class=\"textbox textbox--learning-objectives\"><header class=\"textbox__header\">Revision Checklist<\/header>\r\n<div class=\"textbox__content\">\r\n\r\n<strong>1. First Pass: Document-level Review<\/strong>\r\n<ul>\r\n \t<li>Review specifications to ensure that you have included all required content.<\/li>\r\n \t<li>Make sure your title, headings, subheading, and table\/figure labels are clear and descriptive. Headings should clearly and efficiently indicate the content of that section; Figure and Table captions should clearly describe the content of the visual.<\/li>\r\n \t<li>Make sure visual elements have appropriate passive space around them.<\/li>\r\n \t<li>Make sure ideas flow in a logical order and explanations come in a timely manner. Make sure visuals illustrate your textual information.<\/li>\r\n \t<li>Write \u201cReader-Centered\u201d prose: determine the relationship between your purpose in writing and your reader\u2019s purpose in reading. Give your readers the information they want and need to get from your document as efficiently as possible.<\/li>\r\n \t<li>Make sure you are using an appropriate tone (neutral, objective, constructive, formal)<\/li>\r\n<\/ul>\r\n<strong>2. Second Pass: Paragraph-level Review<\/strong>\r\n<ul>\r\n \t<li>Make sure each paragraph begins with a topic sentence that previews and\/or summarizes the content to come.<\/li>\r\n \t<li>Add coherent transitions to link one sentence logically to the next.<\/li>\r\n \t<li>Cut unnecessary or irrelevant information.<\/li>\r\n \t<li>Avoid overly long or short paragraphs (5-10 lines long is a reasonable guideline).<\/li>\r\n<\/ul>\r\n<strong>3. Third Pass: Sentence-level Review<\/strong>\r\n<ul>\r\n \t<li>Watch sentence length; consider revising sentences longer than 25 words. Vary the length and structure of sentences.<\/li>\r\n \t<li>Look at the ratio of\u00a0<em>verbs<\/em>:<em>number of words per sentence<\/em>. Generally, the more verbs\/words in the sentence, the better the sentence.<\/li>\r\n \t<li>Use concrete, strong, active verbs \u2013 avoid vague, passive, verbs and \u201cis\/are\/was\/were\/being\u201d whenever feasible (move the \u2013<em>tion<\/em>\u00a0and \u2013<em>ment<\/em>\u00a0words up the verb scale).<\/li>\r\n \t<li>Create a clear Actor\/Action relationship (Subject-Verb).<\/li>\r\n \t<li>Verbs like \u201cmake\u201d \u201cdo\u201d \u2018have\u201d and \u201cget\u201d have many possible meanings. Try to find more precise ones.<\/li>\r\n \t<li>In general, keep subject and verb close together, and keep verb near the beginning of the sentence.<\/li>\r\n<\/ul>\r\n<strong>4. Fourth Pass: Word-level Review<\/strong>\r\n<ul>\r\n \t<li>Use concrete, specific, precise words; avoid vague, abstract, generalizing words.<\/li>\r\n \t<li>Match your vocabulary to your audience: experts can tolerate complex information with a lot of terminology; general readers require simpler, less detailed descriptions\/explanations.<\/li>\r\n \t<li>Use clear, plain language rather than pompous diction; write to\u00a0<strong>express<\/strong>, not impress.<\/li>\r\n \t<li>Avoid \u201csound bite\u201d phrases that have no real meaning; use a single word instead of a phrase whenever possible.<\/li>\r\n \t<li>Avoid clich\u00e9s, colloquial expressions, and slang.<\/li>\r\n \t<li>Use second person (you) pronouns carefully and sparingly.<\/li>\r\n \t<li>Avoid \u201cad speak\u201d \u2014 don\u2019t sound like you are \u201cselling\u201d something; use objective, measurable descriptors.<\/li>\r\n<\/ul>\r\n<\/div>\r\n<\/div>\r\nIf your document incorporates sources, you will want to do an additional \u201cpass\u201d to make sure that all sources are cited properly and in chronological order in the body text, and that they all cross-reference to your list of references at the end of the document.","rendered":"<div class=\"textbox learning-objectives\">\n<h3>Learning Objectives<\/h3>\n<ul>\n<li>Review a Revision Checklist<\/li>\n<\/ul>\n<\/div>\n<p class=\"textbox__title\">Anything that you write is designed to be read.\u00a0That is its first and foremost purpose. Thus, increasing readability means increasing the functionality of your document in terms of both content and document design\u2014making it \u201cuser friendly.\u201d If your document is difficult to read because vocabulary, sentence structure, paragraphing, organization, or formatting is unclear, your reader will likely stop reading.<\/p>\n<p class=\"textbox__title\">The\u00a0<strong>Revision Checklist<\/strong>\u00a0below offers a step-by-step process for revising your document to achieve a readable style.\u00a0Implementing this checklist means doing several \u201cpasses\u201d over your document, looking at different aspects each time. For example, in your \u201cfirst pass,\u201d review the entire document for overall formatting, content requirements, coherent flow of information, and appropriate tone.<\/p>\n<div class=\"textbox textbox--learning-objectives\">\n<header class=\"textbox__header\">Revision Checklist<\/header>\n<div class=\"textbox__content\">\n<p><strong>1. First Pass: Document-level Review<\/strong><\/p>\n<ul>\n<li>Review specifications to ensure that you have included all required content.<\/li>\n<li>Make sure your title, headings, subheading, and table\/figure labels are clear and descriptive. Headings should clearly and efficiently indicate the content of that section; Figure and Table captions should clearly describe the content of the visual.<\/li>\n<li>Make sure visual elements have appropriate passive space around them.<\/li>\n<li>Make sure ideas flow in a logical order and explanations come in a timely manner. Make sure visuals illustrate your textual information.<\/li>\n<li>Write \u201cReader-Centered\u201d prose: determine the relationship between your purpose in writing and your reader\u2019s purpose in reading. Give your readers the information they want and need to get from your document as efficiently as possible.<\/li>\n<li>Make sure you are using an appropriate tone (neutral, objective, constructive, formal)<\/li>\n<\/ul>\n<p><strong>2. Second Pass: Paragraph-level Review<\/strong><\/p>\n<ul>\n<li>Make sure each paragraph begins with a topic sentence that previews and\/or summarizes the content to come.<\/li>\n<li>Add coherent transitions to link one sentence logically to the next.<\/li>\n<li>Cut unnecessary or irrelevant information.<\/li>\n<li>Avoid overly long or short paragraphs (5-10 lines long is a reasonable guideline).<\/li>\n<\/ul>\n<p><strong>3. Third Pass: Sentence-level Review<\/strong><\/p>\n<ul>\n<li>Watch sentence length; consider revising sentences longer than 25 words. Vary the length and structure of sentences.<\/li>\n<li>Look at the ratio of\u00a0<em>verbs<\/em>:<em>number of words per sentence<\/em>. Generally, the more verbs\/words in the sentence, the better the sentence.<\/li>\n<li>Use concrete, strong, active verbs \u2013 avoid vague, passive, verbs and \u201cis\/are\/was\/were\/being\u201d whenever feasible (move the \u2013<em>tion<\/em>\u00a0and \u2013<em>ment<\/em>\u00a0words up the verb scale).<\/li>\n<li>Create a clear Actor\/Action relationship (Subject-Verb).<\/li>\n<li>Verbs like \u201cmake\u201d \u201cdo\u201d \u2018have\u201d and \u201cget\u201d have many possible meanings. Try to find more precise ones.<\/li>\n<li>In general, keep subject and verb close together, and keep verb near the beginning of the sentence.<\/li>\n<\/ul>\n<p><strong>4. Fourth Pass: Word-level Review<\/strong><\/p>\n<ul>\n<li>Use concrete, specific, precise words; avoid vague, abstract, generalizing words.<\/li>\n<li>Match your vocabulary to your audience: experts can tolerate complex information with a lot of terminology; general readers require simpler, less detailed descriptions\/explanations.<\/li>\n<li>Use clear, plain language rather than pompous diction; write to\u00a0<strong>express<\/strong>, not impress.<\/li>\n<li>Avoid \u201csound bite\u201d phrases that have no real meaning; use a single word instead of a phrase whenever possible.<\/li>\n<li>Avoid clich\u00e9s, colloquial expressions, and slang.<\/li>\n<li>Use second person (you) pronouns carefully and sparingly.<\/li>\n<li>Avoid \u201cad speak\u201d \u2014 don\u2019t sound like you are \u201cselling\u201d something; use objective, measurable descriptors.<\/li>\n<\/ul>\n<\/div>\n<\/div>\n<p>If your document incorporates sources, you will want to do an additional \u201cpass\u201d to make sure that all sources are cited properly and in chronological order in the body text, and that they all cross-reference to your list of references at the end of the document.<\/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-70\">\n\t\t\t\t\t\t\t <div class=\"licensing\"><div class=\"license-attribution-dropdown-subheading\">CC licensed content, Shared previously<\/div><ul class=\"citation-list\"><li>3.5 Style Tips: Revising to Enhance Readability. <strong>Authored by<\/strong>: Suzan Last. <strong>Provided by<\/strong>: BC Campus. <strong>Located at<\/strong>: <a target=\"_blank\" href=\"https:\/\/pressbooks.bccampus.ca\/technicalwriting\/chapter\/styletipsreadability\/\">https:\/\/pressbooks.bccampus.ca\/technicalwriting\/chapter\/styletipsreadability\/<\/a>. <strong>License<\/strong>: <em><a target=\"_blank\" rel=\"license\" href=\"https:\/\/creativecommons.org\/licenses\/by\/4.0\/\">CC BY: Attribution<\/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":395986,"menu_order":2,"template":"","meta":{"_candela_citation":"[{\"type\":\"cc\",\"description\":\"3.5 Style Tips: Revising to Enhance Readability\",\"author\":\"Suzan Last\",\"organization\":\"BC Campus\",\"url\":\"https:\/\/pressbooks.bccampus.ca\/technicalwriting\/chapter\/styletipsreadability\/\",\"project\":\"\",\"license\":\"cc-by\",\"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-70","chapter","type-chapter","status-publish","hentry"],"part":68,"_links":{"self":[{"href":"https:\/\/courses.lumenlearning.com\/suny-technicalwriting\/wp-json\/pressbooks\/v2\/chapters\/70","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/courses.lumenlearning.com\/suny-technicalwriting\/wp-json\/pressbooks\/v2\/chapters"}],"about":[{"href":"https:\/\/courses.lumenlearning.com\/suny-technicalwriting\/wp-json\/wp\/v2\/types\/chapter"}],"author":[{"embeddable":true,"href":"https:\/\/courses.lumenlearning.com\/suny-technicalwriting\/wp-json\/wp\/v2\/users\/395986"}],"version-history":[{"count":2,"href":"https:\/\/courses.lumenlearning.com\/suny-technicalwriting\/wp-json\/pressbooks\/v2\/chapters\/70\/revisions"}],"predecessor-version":[{"id":355,"href":"https:\/\/courses.lumenlearning.com\/suny-technicalwriting\/wp-json\/pressbooks\/v2\/chapters\/70\/revisions\/355"}],"part":[{"href":"https:\/\/courses.lumenlearning.com\/suny-technicalwriting\/wp-json\/pressbooks\/v2\/parts\/68"}],"metadata":[{"href":"https:\/\/courses.lumenlearning.com\/suny-technicalwriting\/wp-json\/pressbooks\/v2\/chapters\/70\/metadata\/"}],"wp:attachment":[{"href":"https:\/\/courses.lumenlearning.com\/suny-technicalwriting\/wp-json\/wp\/v2\/media?parent=70"}],"wp:term":[{"taxonomy":"chapter-type","embeddable":true,"href":"https:\/\/courses.lumenlearning.com\/suny-technicalwriting\/wp-json\/pressbooks\/v2\/chapter-type?post=70"},{"taxonomy":"contributor","embeddable":true,"href":"https:\/\/courses.lumenlearning.com\/suny-technicalwriting\/wp-json\/wp\/v2\/contributor?post=70"},{"taxonomy":"license","embeddable":true,"href":"https:\/\/courses.lumenlearning.com\/suny-technicalwriting\/wp-json\/wp\/v2\/license?post=70"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}