{
    "version" : "https://jsonfeed.org/version/1",
    "content" : "news",
    "type" : "single",
    "title" : "The Content Corner: Creating a Content Style Guide |Digital.gov",
    "description": "The Content Corner: Creating a Content Style Guide",
    "home_page_url" : "/preview/gsa/digitalgov.gov/bc-archive-content-3/","feed_url" : "/preview/gsa/digitalgov.gov/bc-archive-content-3/2015/06/08/the-content-corner-creating-a-content-style-guide/index.json","item" : [
    {"title" :"The Content Corner: Creating a Content Style Guide","summary" : "One of the more commonly overlooked pieces of any effective content strategy is a content style guide.","date" : "2015-06-08T10:00:02-04:00","date_modified" : "2025-01-27T19:42:55-05:00","authors" : {"tyrus-manuel" : "Tyrus Manuel"},"topics" : {
        
            "content-strategy" : "Content strategy"
            },"branch" : "bc-archive-content-3",
      "filename" :"2015-06-08-the-content-corner-creating-a-content-style-guide.md",
      
      "filepath" :"news/2015/06/2015-06-08-the-content-corner-creating-a-content-style-guide.md",
      "filepathURL" :"https://github.com/GSA/digitalgov.gov/blob/bc-archive-content-3/content/news/2015/06/2015-06-08-the-content-corner-creating-a-content-style-guide.md",
      "editpathURL" :"https://github.com/GSA/digitalgov.gov/edit/bc-archive-content-3/content/news/2015/06/2015-06-08-the-content-corner-creating-a-content-style-guide.md","slug" : "the-content-corner-creating-a-content-style-guide","url" : "/preview/gsa/digitalgov.gov/bc-archive-content-3/2015/06/08/the-content-corner-creating-a-content-style-guide/","content" :"\u003cdiv class=\"image\"\u003e\n  \u003cimg\n    src=\"https://s3.amazonaws.com/digitalgov/_legacy-img/2015/06/600-x-400-Typing-lucky336-iStock-Thinkstock-459117607.jpg\"\n    alt=\"Hands typing on a laptop keyboard.\"/\u003e\u003c/div\u003e\n\n\n\u003cp\u003eOne of the more commonly overlooked pieces of any effective content strategy is a content style guide. Many times, content contribution takes place without even being aware of the need for a style guide, while other times a content style guide is considered something only used by print editors and publishers.\u003c/p\u003e\n\u003cp\u003eStalwarts like the \u003ca href=\"https://www.apstylebook.com/\"\u003eAP Stylebook\u003c/a\u003e or the \u003ca href=\"http://www.chicagomanualofstyle.org/\"\u003eChicago Manual of Style\u003c/a\u003e have been essential tools for editors and journalists since the 1950s, but they also have a critical role to play in the development of any content style guide. And if you have more than one person contributing content to your agency’s website, then you need a style guide. And to be honest: if the one person is someone like me, who seems to strive subconsciously for inconsistency, you still need a style guide.\u003c/p\u003e\n\u003ch2 id=\"more-than-proper-colon-usage\"\u003eMore than Proper Colon Usage\u003c/h2\u003e\n\u003cp\u003eMany people mistakenly view style guides as a rarely used tome to help settle heated arguments about colon usage, split infinitives, or gerunds. And while it can be very helpful in this regard, it also helps establish what I personally feel is the most critical component of content creation: \u003cstrong\u003econsistency\u003c/strong\u003e. Many times I have uttered the words “I don’t care how we handle it, just be sure we’re consistent.” And more often than not, directly after this phrase is uttered and a decision is made, it is quickly documented in the style guide.\u003c/p\u003e\n\u003cp\u003eA good style guide can also answer questions about how to present a content type such as a graphic or table before they even can occur. This helps save the content contributor time and also reduces the time needed during the content review process, if one exists. I have always sought out the warm embrace of a content style guide when posting content for a new site or in a new publishing environment. To me, it serves as an insurance policy that the content I’m creating is as correct as possible the first time.\u003c/p\u003e\n\u003cp\u003eA style guide is also an important vehicle for establishing the \u003ca href=\"/preview/gsa/digitalgov.gov/bc-archive-content-3/2015/04/20/the-content-corner-finding-your-voice/\"\u003evoice and tone\u003c/a\u003e of your agency or office. One example from \u003ca href=\"https://blog.gathercontent.com/\"\u003eGather Content’s blog\u003c/a\u003e shows how Apple would define their voice via a style guide:\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eCalm, but not passive\u003c/li\u003e\n\u003cli\u003eConfident, but not arrogant\u003c/li\u003e\n\u003cli\u003eInnovative, but not flash\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003eIf you need a good starting point for getting a better grip on your agency’s personality, take a look at Big Brand System’s 10 minute \u003ca href=\"http://bbsmedia.s3.amazonaws.com/Brand_Personality.pdf\"\u003epersonality exercise\u003c/a\u003e.\u003c/p\u003e\n\u003cp\u003eMost importantly, a content style guide serves as a reference tool for your \u003ca href=\"/preview/gsa/digitalgov.gov/bc-archive-content-3/2015/03/23/the-content-corner-building-a-content-strategy/\"\u003econtent strategy\u003c/a\u003e and helps ensure that your strategy is a part of every piece of content created. This should also serve to help keep your content efficient and user-focused while also asking whether the piece of content needs to be created in the first place.\u003c/p\u003e\n\u003ch2 id=\"build-upon-the-work-of-others\"\u003eBuild Upon the Work of Others\u003c/h2\u003e\n\u003cp\u003e\u003cdiv class=\"image\"\u003e\n  \u003cimg\n    src=\"https://s3.amazonaws.com/digitalgov/_legacy-img/2015/06/250-x-316-The-Yahoo-Style-Guide-The-Ultimate-Sourcebook-for-Writing-Editing-and-Creating-Content-for-the-Digital-World.jpg\"\n    alt=\"The front cover of the book titled, The Yahoo! Style Guide: The Ultimate Sourcebook for Writing, Editing, and Creating Content for the Digital World.\"/\u003e\u003c/div\u003e\n\nAnother common misconception about content style guides are that they are hard to develop and time-consuming. I personally have never found this to be the case when developing either a print style guide or a Web style guide. One of the main reasons developing your own style guide is relatively easy is that either the AP or Chicago guides can serve as your extremely strong foundation. Yahoo also has a \u003ca href=\"http://www.businessinsider.com/yahoo-publishes-a-style-guide-for-the-internet-2010-4\"\u003epopular style guide\u003c/a\u003e that is Internet-focused (as expected). Your agency may have, at a minimum, decided on one of these main guides; in my experience it is typically Chicago, but either way, a lot of the hard work has already been done for you. Just be sure to specify in your guide when an in-house style overrides something in one of the core guides.\u003c/p\u003e\n\u003cp\u003eFrom there, you just need to review the content strategy you have in place and personalize accordingly, adding guidance for a wide variety of items such as:\u003c/p\u003e\n\u003cul\u003e\n\u003cli\u003eThe tone and voice of the content\u003c/li\u003e\n\u003cli\u003eTypical content length\u003c/li\u003e\n\u003cli\u003eContent structure such as usage of h1, h2 and other HTML tags\u003c/li\u003e\n\u003cli\u003eImage placement and caption rules\u003c/li\u003e\n\u003cli\u003eURL placement and usage (do you show the URL or just link?)\u003c/li\u003e\n\u003c/ul\u003e\n\u003ch2 id=\"a-living-document-hahahugoshortcode2492s4hbhb\"\u003eA Living Document \u003cdiv class=\"image\"\u003e\n  \u003cimg\n    src=\"https://s3.amazonaws.com/digitalgov/_legacy-img/2015/06/250-x-167-Computer-key-modify-socket-wrench-symbol-jurgenfr-iStock-Thinkstock-478284945.jpg\"\n    alt=\"Computer key - modify socket wrench symbol\"/\u003e\u003c/div\u003e\n\n\u003c/h2\u003e\n\u003cp\u003eJust as your website is not a print product that gets shipped in some final state, your agency’s style guide should never be considered final. As your digital products continue to change and grow, previous styles will need to be updated and completely new styles may need to be developed. What worked for your Facebook page may not work for whatever new platform your agency has adopted and is using to reach more customers.\u003c/p\u003e\n\u003cp\u003eIt is also important to point out that not only should your style guide be allowed to evolve and grow as your digital offerings do, it should also not be considered a guide for only text content. It can be used to establish norms for visual media as well, such as videos or infographics. I’m still trying to wrap my head around a style guide entry for Periscope, but it is certainly something that you might need to consider. It is again about helping maintain a consistent presence to customers in all public forms, whether it is a PDF or a Snapchat or a new pin on Pinterest.\u003c/p\u003e\n\u003ch2 id=\"so-simple-a-child-could-use-it\"\u003eSo Simple a Child Could Use It\u003c/h2\u003e\n\u003cp\u003eMany organizations that have developed style guides still suffer problems of consistency and “rogue” content contributors, and they struggle to get their editors to make use of the guide. One of the main ways to be sure your style guide is used is to \u003cstrong\u003emake it usable\u003c/strong\u003e. A simple, straightforward guide for creating content will normally be embraced by others the same way I mentioned that I embrace them. It makes a content contributor’s job easier by reducing questions and reducing time needed to revise or correct mistakes once content is reviewed as part of the publishing workflow.\u003c/p\u003e\n\u003cp\u003eIt can also be helpful (and it always makes sense to me) to include a group of content editors or contributors into the style guide creation process. Are there questions that always come up? Do several of your editors have their own “unofficial” style guides that they created for themselves? This also helps create a guide that has a basis in the everyday reality and workflow of the people that you will expect to use it on a regular basis. Style guide by royal edict is normally not a good way to engender broad acceptance or use.\u003c/p\u003e\n\u003cp\u003eA content style guide (or any style guide, for that matter) is always a must-have for me, and if I join an organization without one, I very quickly volunteer to take on a project to create one. Maybe I am a bit of a structure nut, but it creates a much more consistent and less confusing content creation process (not to mention less confusing content for the customer). It is normally a small amount of effort for a large return in time and quality, and it doesn’t have to be complicated. I have had style guides that were simple Word documents, and I have had a searchable Wiki, but the important thing is that it exists, is easily accessible, and is easy to follow—just like your content itself should be.\u003cem\u003eYou’ve just finished reading the latest article from our Monday column, \u003ca href=\"/preview/gsa/digitalgov.gov/bc-archive-content-3/topics/content-strategy/\"\u003eThe Content Corner\u003c/a\u003e. This column focuses on helping solve the main content issues facing federal digital professionals, including producing enough content and making that content engaging.\u003c/em\u003e\u003c/p\u003e\n"}
  ]
}