{"id":2070,"date":"2019-08-21T19:07:12","date_gmt":"2019-08-21T19:07:12","guid":{"rendered":"http:\/\/sites.la.utexas.edu\/kb\/?p=2070"},"modified":"2021-02-02T18:22:10","modified_gmt":"2021-02-02T18:22:10","slug":"add-new-documentation-to-the-cola-help-guides","status":"publish","type":"post","link":"http:\/\/sites.la.utexas.edu\/kb\/2019\/08\/21\/add-new-documentation-to-the-cola-help-guides\/","title":{"rendered":"Creating New Documentation for Faculty and Staff"},"content":{"rendered":"<p><span style=\"color: #000000\">The <a style=\"color: #000000\" href=\"https:\/\/liberalarts.utexas.edu\/web-admin-help\/index.php\">COLA Help Guides<\/a> provide detailed instructions on how to use both\u00a0<a style=\"color: #000000\" href=\"https:\/\/cms.la.utexas.edu\/login.act\">Cascade CMS<\/a> and the <a style=\"color: #000000\" href=\"https:\/\/colaweb.la.utexas.edu\/login\">COLA Web Editor.<\/a>\u00a0The audience for these guides is COLA faculty and staff who use these tools to manage their sites, so keep in mind that these guides are public-facing.<\/span><\/p>\n<p><span style=\"color: #000000\">When faculty or staff submit requests for web support, there will either be existing documentation that you can point them to, or it might be necessary to create new documentation for a problem that hasn&#8217;t been addressed before.<\/span><\/p>\n<p><span style=\"color: #000000\">This page will walk you through the process of publishing new documentation. Refer to\u00a0<a style=\"color: #000000\" href=\"#myanchor\">the style guide<\/a>\u00a0whenever you have questions about the formatting of documentation.<\/span><\/p>\n<hr \/>\n<p><a href=\"https:\/\/liberalarts.utexas.edu\/web-admin-help\/index.php\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-1638\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2012\/03\/web-services-banner01.png\" alt=\"\" width=\"870\" height=\"300\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2012\/03\/web-services-banner01.png 870w, http:\/\/sites.la.utexas.edu\/kb\/files\/2012\/03\/web-services-banner01-300x103.png 300w, http:\/\/sites.la.utexas.edu\/kb\/files\/2012\/03\/web-services-banner01-768x265.png 768w\" sizes=\"auto, (max-width: 870px) 100vw, 870px\" \/><\/a><\/p>\n<hr \/>\n<p><a href=\"https:\/\/liberalarts.utexas.edu\/web-admin-help\/index.php\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-2074\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.10.39-PM.png\" alt=\"\" width=\"194\" height=\"199\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.10.39-PM.png 1210w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.10.39-PM-293x300.png 293w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.10.39-PM-768x788.png 768w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.10.39-PM-998x1024.png 998w\" sizes=\"auto, (max-width: 194px) 100vw, 194px\" \/>\u00a0<\/a><a href=\"https:\/\/liberalarts.utexas.edu\/web-admin-help\/accounts\/cascade-access\/new-account.php\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-2075\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.11.02-PM.png\" alt=\"\" width=\"183\" height=\"199\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.11.02-PM.png 1204w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.11.02-PM-276x300.png 276w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.11.02-PM-768x834.png 768w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.11.02-PM-943x1024.png 943w\" sizes=\"auto, (max-width: 183px) 100vw, 183px\" \/>\u00a0<\/a><a href=\"https:\/\/liberalarts.utexas.edu\/web-admin-help\/graphics\/copy-right-free-images.php\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-2076\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.11.24-PM.png\" alt=\"\" width=\"184\" height=\"199\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.11.24-PM.png 1196w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.11.24-PM-278x300.png 278w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.11.24-PM-768x829.png 768w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.11.24-PM-949x1024.png 949w\" sizes=\"auto, (max-width: 184px) 100vw, 184px\" \/><\/a><\/p>\n<h2><strong>1) Read Through the Original Help Request<\/strong><\/h2>\n<p>When a staff or faculty member contacts LAITS with a problem that doesn&#8217;t have documentation yet, you&#8217;ll need to read through their email to identify the relevant issues.<\/p>\n<p>Make a note of what topic(s) need to be documented in\u00a0<a href=\"https:\/\/docs.google.com\/spreadsheets\/d\/1QEzqvw70s-YzmCvMlsAo-E_Bg2pUouZBUPw9v6kuvJ0\/edit?usp=sharing\">the COLA Help Guides tracking spreadsheet.<\/a>\u00a0You can also make yourself a Basecamp to-do if you want feedback from your peers or mentors on the documentation you create.<\/p>\n<ul>\n<li>What&#8217;s the main issue? Is it a COLA Web Editor issue, a Cascade issue, or both?<\/li>\n<li>Are there related issues? E.g., when deleting pages, it&#8217;s also helpful to know that pages can be restored<\/li>\n<li>Can all the documentation fit on one page? Should it have subsections?<\/li>\n<\/ul>\n<hr \/>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-2083 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.38.10-PM.png\" alt=\"\" width=\"647\" height=\"1150\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.38.10-PM.png 647w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.38.10-PM-169x300.png 169w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-2.38.10-PM-576x1024.png 576w\" sizes=\"auto, (max-width: 647px) 100vw, 647px\" \/><\/p>\n<hr \/>\n<h2><strong>2) Create a New Page in Cascade<\/strong><\/h2>\n<p>Log in to <a href=\"https:\/\/cms.la.utexas.edu\/login.act\">Cascade CMS<\/a>. Go to <strong>Units &gt; web-admin-help<\/strong>.<\/p>\n<p>There are four existing categories in the Help Guides. They are listed as folders under the parent category web-admin-help.<\/p>\n<ul>\n<li><strong>Creating Accounts<\/strong> (accounts)<\/li>\n<li><strong>How to Use Cascade\u00a0<\/strong>(how-use-cascade)<\/li>\n<li><strong>How to Use the Web Editor<\/strong> (how-to-use-the-web-editor)<\/li>\n<li><strong>Graphics &amp; Images<\/strong> (graphics)<\/li>\n<\/ul>\n<hr \/>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-2094 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.29.36-PM.png\" alt=\"\" width=\"297\" height=\"712\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.29.36-PM.png 297w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.29.36-PM-125x300.png 125w\" sizes=\"auto, (max-width: 297px) 100vw, 297px\" \/><\/p>\n<hr \/>\n<p>Select the folder you want to add a page to. (Check the path at the top of the page to make sure only the folder is selected.)<\/p>\n<p>Click on the <strong>Add Content<\/strong> button to add a page to the folder.<\/p>\n<hr \/>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-2100 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.41.38-PM.png\" alt=\"\" width=\"1388\" height=\"582\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.41.38-PM.png 1388w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.41.38-PM-300x126.png 300w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.41.38-PM-768x322.png 768w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.41.38-PM-1024x429.png 1024w\" sizes=\"auto, (max-width: 1388px) 100vw, 1388px\" \/><\/p>\n<hr \/>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-2101 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.42.03-PM.png\" alt=\"\" width=\"372\" height=\"494\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.42.03-PM.png 372w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.42.03-PM-226x300.png 226w\" sizes=\"auto, (max-width: 372px) 100vw, 372px\" \/><\/p>\n<hr \/>\n<p><em><strong>Note:<\/strong><\/em> New pages will be added to the bottom of the list. If you want to reorder the pages so they show up in a specific order in the navigation bar, do the following:<\/p>\n<ul>\n<li>Click <strong>Order\u00a0<\/strong>to sort the pages<\/li>\n<li>Select the page you want to rearrange<\/li>\n<li>Use the up and down arrows that appear to change its order in the navigation<\/li>\n<li>Publish the changes<\/li>\n<\/ul>\n<hr \/>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-2103 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.45.28-PM.png\" alt=\"\" width=\"1087\" height=\"641\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.45.28-PM.png 1087w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.45.28-PM-300x177.png 300w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.45.28-PM-768x453.png 768w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.45.28-PM-1024x604.png 1024w\" sizes=\"auto, (max-width: 1087px) 100vw, 1087px\" \/><\/p>\n<hr \/>\n<h2><strong>3) Make Your Page Hidden<\/strong><\/h2>\n<p>Before you start your draft, go to the <strong>Configure<\/strong> tab in the editing window. Uncheck both <strong>Include when indexing<\/strong> and <strong>Include when publishing<\/strong>. This will keep the page from being published or visible in the navigation bar until it&#8217;s been approved, and anyone who publishes the parent folder won&#8217;t accidentally publish your page to the web.<\/p>\n<hr \/>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-2105 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.57.18-PM.png\" alt=\"\" width=\"896\" height=\"551\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.57.18-PM.png 896w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.57.18-PM-300x184.png 300w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-3.57.18-PM-768x472.png 768w\" sizes=\"auto, (max-width: 896px) 100vw, 896px\" \/><\/p>\n<hr \/>\n<h2><strong>4) Start Your Draft<\/strong><\/h2>\n<p>Go to the <strong>Content<\/strong> tab in the editing window. Give your page a <strong>display name<\/strong>\u00a0(the name that shows up in the navigation) and a <strong>page headline<\/strong>. (<a href=\"https:\/\/liberalarts.utexas.edu\/web-admin-help\/how-to-use-cascade\/advanced-topics\/rename-pages.php\">Learn about the different page names that exist<\/a>.)<\/p>\n<p>Generally, all of the content will go in the section <strong>main-body-content<\/strong>. Start composing your draft there, and follow the style guide (below) as closely as possible. (<a href=\"#myanchor\">Jump to the Style Guide.<\/a>)<\/p>\n<hr \/>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-2111 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-4.21.22-PM.png\" alt=\"\" width=\"896\" height=\"1191\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-4.21.22-PM.png 896w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-4.21.22-PM-226x300.png 226w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-4.21.22-PM-768x1021.png 768w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-21-at-4.21.22-PM-770x1024.png 770w\" sizes=\"auto, (max-width: 896px) 100vw, 896px\" \/><\/p>\n<hr \/>\n<h2><strong>4) Save and Submit Your Page<\/strong><\/h2>\n<p>As you&#8217;re working on your draft,\u00a0 periodically click on the <strong>Save &amp; Preview<\/strong> button&#8230;<\/p>\n<hr \/>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-2125 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.11.52-AM.png\" alt=\"\" width=\"236\" height=\"76\" \/><\/p>\n<hr \/>\n<p>and the <strong>Submit<\/strong> button so you don&#8217;t lose your work.<\/p>\n<hr \/>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-2126 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.12.57-AM.png\" alt=\"\" width=\"526\" height=\"290\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.12.57-AM.png 526w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.12.57-AM-300x165.png 300w\" sizes=\"auto, (max-width: 526px) 100vw, 526px\" \/><\/p>\n<hr \/>\n<h2><strong>5) Upload Screenshots to Your Page<\/strong><\/h2>\n<p>As you&#8217;re writing your draft, take screenshots to illustrate each step.<\/p>\n<hr \/>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-2118 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-10.54.21-AM.png\" alt=\"\" width=\"560\" height=\"308\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-10.54.21-AM.png 603w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-10.54.21-AM-300x165.png 300w\" sizes=\"auto, (max-width: 560px) 100vw, 560px\" \/><\/p>\n<hr \/>\n<p>Press <strong>command + shift + 5<\/strong> to bring up <a href=\"https:\/\/support.apple.com\/en-us\/HT201361\">screen capture options<\/a><span style=\"color: #000000\">. To screenshot a selected area, click on <strong>Capture Selected Portion<\/strong> and press the <strong>Capture<\/strong> button.<\/span><\/p>\n<p>The screenshot will appear on your desktop. Double click to view it.<\/p>\n<p>Add red boxes to the screenshots to highlight important areas<span style=\"color: #000000\">\u2014the easiest way to do that is to click the <strong>markup button<\/strong>\u00a0<img loading=\"lazy\" decoding=\"async\" class=\"alignnone wp-image-2122\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.02.57-AM.png\" alt=\"\" width=\"42\" height=\"29\" \/> while viewing the image, then use the toolbar to add a square with no fill and a red line color.<\/span><\/p>\n<hr \/>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-2123 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.06.03-AM.png\" alt=\"\" width=\"540\" height=\"214\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.06.03-AM.png 540w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.06.03-AM-300x119.png 300w\" sizes=\"auto, (max-width: 540px) 100vw, 540px\" \/><\/p>\n<hr \/>\n<p>Upload the screenshots to your page by going to <strong>Units &gt; web-admin-help &gt; _files<\/strong>.<\/p>\n<p>Click the <strong>Add Content<\/strong> button, then <strong>Upload file or image<\/strong>.<\/p>\n<p><em><strong>Note<\/strong><\/em>: It can be problematic to have multiple Cascade tabs open<span style=\"color: #000000\">\u2014save your draft before uploading files to Cascade so you don&#8217;t accidentally lose work.<\/span><\/p>\n<hr \/>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-2143 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.40.57-AM.png\" alt=\"\" width=\"1241\" height=\"692\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.40.57-AM.png 1241w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.40.57-AM-300x167.png 300w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.40.57-AM-768x428.png 768w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.40.57-AM-1024x571.png 1024w\" sizes=\"auto, (max-width: 1241px) 100vw, 1241px\" \/><\/p>\n<hr \/>\n<h2><strong>6) Get Your Page Reviewed and Make Edits<\/strong><\/h2>\n<p>Post the URL to your Cascade page to the Basecamp to-do and @ Suloni or another STA to review your work. Use their suggestions to make any necessary edits to the page before it goes live.<\/p>\n<hr \/>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-2144 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.31.17-AM.png\" alt=\"\" width=\"709\" height=\"374\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.31.17-AM.png 709w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.31.17-AM-300x158.png 300w\" sizes=\"auto, (max-width: 709px) 100vw, 709px\" \/><\/p>\n<hr \/>\n<h2><strong>7) Publish the Page Once It&#8217;s Approved<\/strong><\/h2>\n<p>After Suloni or another STA reviews your work and approves it, go ahead and publish the page.<\/p>\n<ul>\n<li>Go to the page and click on the <strong>Edit<\/strong> button<\/li>\n<li>Go to the <strong>Configure<\/strong> tab and recheck the boxes for <strong>Include when indexing<\/strong> and <strong>Include when publishing<\/strong><\/li>\n<\/ul>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-2145 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.51.22-AM.png\" alt=\"\" width=\"897\" height=\"218\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.51.22-AM.png 897w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.51.22-AM-300x73.png 300w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-11.51.22-AM-768x187.png 768w\" sizes=\"auto, (max-width: 897px) 100vw, 897px\" \/><\/p>\n<ul>\n<li>Click <strong>Save &amp; Preview<\/strong>, then <strong>Submit<\/strong>, then <strong>Publish<\/strong><\/li>\n<li>The page will be added to the publishing queue<\/li>\n<li>Post the live page URL to the Basecamp to-do<\/li>\n<\/ul>\n<p><em><strong>Note:<\/strong><\/em> It may take up to 24 hours for the page to go live<span style=\"color: #000000\">\u2014don&#8217;t worry if the page doesn&#8217;t update immediately.<\/span><\/p>\n<hr \/>\n<h1 id=\"myanchor\"><span style=\"color: #000000\">Style Guide\u2014<em><span style=\"color: #000080\">COLA Help Guides<\/span><\/em><\/span><\/h1>\n<hr \/>\n<h3><strong>Display Name <\/strong>(the Navigation Title)<\/h3>\n<hr \/>\n<ul>\n<li>Applies to folders and pages that have <strong>Include when indexing<\/strong> and <strong>Include when publishing<\/strong> checked<\/li>\n<li>If the first word is a verb, it should take the -ing form (e.g., <a href=\"https:\/\/liberalarts.utexas.edu\/web-admin-help\/how-to-use-cascade\/navigating-to-a-page.php\">Navigating to a Page<\/a>).<\/li>\n<li>Keep it relatively short<\/li>\n<li>Articles (a, an, the) and coordinating conjunctions (and, but, for, or, etc) should be lowercase unless at the beginning of the title; everything else is capitalized<\/li>\n<\/ul>\n<h3><strong>Page Headline<\/strong><\/h3>\n<hr \/>\n<ul>\n<li>Page headlines should start with &#8220;How to [Verb]&#8230;&#8221;\u00a0(e.g., <a href=\"https:\/\/liberalarts.utexas.edu\/web-admin-help\/how-to-use-cascade\/navigating-to-a-page.php\">How to Navigate to a Page<\/a>)<\/li>\n<li>Usually longer\/more descriptive than the display name<\/li>\n<li>Should only take up one line<\/li>\n<li>Articles (a, an, the) and coordinating conjunctions (and, but, for, or, etc) should be lowercase unless at the beginning of the title; everything else is capitalized<\/li>\n<\/ul>\n<h3><strong>Main Body Content<\/strong><\/h3>\n<hr \/>\n<h4><strong>Headline Subtitle<\/strong><\/h4>\n<hr \/>\n<p><em>Optional.<\/em> You can include a subtitle under the page headline. Begin the main body content with a sentence or two (<span style=\"color: #ff0000\">format = paragraph<\/span>), then skip a line before the first step.<\/p>\n<h4><strong>Steps<\/strong><\/h4>\n<hr \/>\n<ul>\n<li>Step numbers should be spelled out (Step One, Step Two), followed by a colon<\/li>\n<li>Steps are in the imperative form (Go, Navigate, Find)<\/li>\n<li><span style=\"color: #ff0000\">format = Heading 3<\/span><\/li>\n<li>Limit yourself to 6-7 steps total<\/li>\n<\/ul>\n<h4><strong>Images<\/strong><\/h4>\n<hr \/>\n<ul>\n<li>Generally, use 1-2 images per step<\/li>\n<li>Add a horizontal line after each image (to prevent text from wrapping around the image)<\/li>\n<\/ul>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-2157 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-12.46.51-PM.png\" alt=\"\" width=\"770\" height=\"316\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-12.46.51-PM.png 770w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-12.46.51-PM-300x123.png 300w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-12.46.51-PM-768x315.png 768w\" sizes=\"auto, (max-width: 770px) 100vw, 770px\" \/><\/p>\n<ul>\n<li>Skip a line before an image and after the horizontal line<\/li>\n<\/ul>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-2159 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-1.53.13-PM.png\" alt=\"\" width=\"350\" height=\"308\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-1.53.13-PM.png 448w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-1.53.13-PM-300x264.png 300w\" sizes=\"auto, (max-width: 350px) 100vw, 350px\" \/><\/p>\n<h4><strong>Other Tips<\/strong><\/h4>\n<hr \/>\n<ul>\n<li>Minimize use of quotation marks. Use bolded text (Click on &#8220;Go to a Site&#8221; vs. Click on <strong>Go to a Site<\/strong>)<\/li>\n<li>Use bullets to simplify information<\/li>\n<\/ul>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"wp-image-2161 aligncenter\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-1.59.23-PM.png\" alt=\"\" width=\"375\" height=\"155\" srcset=\"http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-1.59.23-PM.png 544w, http:\/\/sites.la.utexas.edu\/kb\/files\/2019\/08\/Screen-Shot-2019-08-22-at-1.59.23-PM-300x124.png 300w\" sizes=\"auto, (max-width: 375px) 100vw, 375px\" \/><\/p>\n<ul>\n<li><em><strong>Note:<\/strong><\/em> Notes should follow this formatting.<\/li>\n<li>If it makes sense to have subcategories in a single step, use<span style=\"color: #ff0000\"> format = Heading 4\u00a0<span style=\"color: #000000\">with a horizontal line underneath<\/span><\/span><\/li>\n<li>Add URL links whenever you think they will be helpful; images can have links too<\/li>\n<\/ul>\n<p><a href=\"https:\/\/cms.la.utexas.edu\/login.act\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-1669\" src=\"https:\/\/sites.la.utexas.edu\/kb\/files\/2019\/07\/Screen-Shot-2019-07-30-at-10.27.22-AM.png\" alt=\"\" width=\"80\" height=\"59\" \/><\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>The COLA Help Guides provide detailed instructions on how to use both\u00a0Cascade CMS and the COLA Web Editor.\u00a0The audience for these guides is COLA faculty and staff who use these tools to manage their sites, so keep in mind that &hellip; <a href=\"http:\/\/sites.la.utexas.edu\/kb\/2019\/08\/21\/add-new-documentation-to-the-cola-help-guides\/\">Continue reading <span class=\"meta-nav\">&rarr;<\/span><\/a><\/p>\n","protected":false},"author":702,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"ngg_post_thumbnail":0,"footnotes":""},"categories":[227824],"tags":[],"class_list":["post-2070","post","type-post","status-publish","format-standard","hentry","category-cascade"],"_links":{"self":[{"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/posts\/2070","targetHints":{"allow":["GET"]}}],"collection":[{"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/users\/702"}],"replies":[{"embeddable":true,"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/comments?post=2070"}],"version-history":[{"count":80,"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/posts\/2070\/revisions"}],"predecessor-version":[{"id":5843,"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/posts\/2070\/revisions\/5843"}],"wp:attachment":[{"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/media?parent=2070"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/categories?post=2070"},{"taxonomy":"post_tag","embeddable":true,"href":"http:\/\/sites.la.utexas.edu\/kb\/wp-json\/wp\/v2\/tags?post=2070"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}