<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>Brain Traffic Blog &#187; Style Guides and Such</title>
	<atom:link href="http://blog.braintraffic.com/category/style-guides-and-such/feed/" rel="self" type="application/rss+xml" />
	<link>http://blog.braintraffic.com</link>
	<description>Just another WordPress weblog</description>
	<lastBuildDate>Thu, 29 Jul 2010 22:05:04 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.0</generator>
		<item>
		<title>Anatomy of a web content document</title>
		<link>http://blog.braintraffic.com/2010/02/anatomy-of-a-web-content-document/</link>
		<comments>http://blog.braintraffic.com/2010/02/anatomy-of-a-web-content-document/#comments</comments>
		<pubDate>Tue, 23 Feb 2010 17:34:46 +0000</pubDate>
		<dc:creator>Amy Wallace</dc:creator>
				<category><![CDATA[Content Strategy]]></category>
		<category><![CDATA[Style Guides and Such]]></category>
		<category><![CDATA[Uncategorized]]></category>
		<category><![CDATA[Web Content]]></category>
		<category><![CDATA[Web Writing]]></category>

		<guid isPermaLink="false">http://blog.braintraffic.com/?p=1012</guid>
		<description><![CDATA[Knowing how to format a web content document—or simply how to read it—is a crucial step in successful content creation.]]></description>
			<content:encoded><![CDATA[<p><span style="font-size: 10pt;">For anyone who works with content, knowing how to format a web content document&mdash;or simply how to read it&mdash;is a crucial step in successful content creation.</span>&nbsp;</p>
<div><span style="font-size: 10pt;">Why? Because without a clearly structured web content document, you run the risk of confusing your content reviewers, designers, and developers. And that confusion can lead to mistakes and frustration&mdash;stuff that could end up manifesting itself on your website.</span></div>
<div>&nbsp;</div>
<div><span style="font-size: 10pt;">Remember, a web content document isn&#8217;t just used by web writers, even though they are often the people who create and manage it. </span></div>
<div>&nbsp;</div>
<div><span style="font-size: 10pt;">Content reviewers use it to make copy edits and review messaging/tone. Designers use it to get the right copy into their design mock-ups. Developers use it to determine which copy appears as links on the actual website, and when to display dynamic content&mdash;for example, content that goes live on a specific date. </span></div>
<div>&nbsp;</div>
<div><span style="font-size: 10pt;">Here are a few of the formatting essentials you&#8217;ll need to cover to make sure your web content document (commonly called a &ldquo;copy deck&rdquo;) works for everyone on your marketing and/or creative team(s):</span></div>
<div>&nbsp;</div>
<div><b><span style="font-size: 10pt;">Links and buttons </span></b></div>
<div><span style="font-size: 10pt;">You can count on link and/or button copy to be in just about every web content document you work with. As you probably know, this is the content that takes the user to a new page, cross-references relevant information, or helps a user complete a task.</span></div>
<div><b>&nbsp;</b></div>
<div><span style="font-size: 10pt;">You&#8217;ll need to choose a style for representing links and buttons in your document. Our standard is to format this copy as blue, underlined text. This tends to be the industry standard, too.</span></div>
<div>&nbsp;</div>
<div><i><span style="font-size: 10pt;">Examples:</span></i></div>
<div><i>&nbsp;</i></div>
<div style="margin-left: 0.5in;"><u><span style="font-size: 10pt; color: blue;">Read the Brain Traffic blog</span></u></div>
<div style="margin-left: 0.5in;">&nbsp;</div>
<div style="margin-left: 0.5in;"><u><span style="font-size: 10pt; color: blue;">Submit your request</span></u></div>
<div>&nbsp;</div>
<div><span style="font-size: 10pt;">If you do decide to format the links and buttons in your document in a different style, make sure it&#8217;s clear&mdash;and that everyone on your team knows what it is. Keep in mind that straying from the norm might confuse reviewers, designers, and developers used to working with the standard blue, underlined text style convention.</span></div>
<div>&nbsp;</div>
<div><span style="font-size: 10pt;">Regardless of the style you choose, follow the link and button text in your content document with its destination, which will likely be based on a site map or an external URL.</span></div>
<div>&nbsp;</div>
<div><i><span style="font-size: 10pt;">Examples:</span></i></div>
<div><i>&nbsp;</i></div>
<div><i><span style="font-size: 10pt;">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></i><span style="font-size: 10pt;">Site map page ID<i>:</i></span></div>
<div style="margin-left: 0.5in;"><u><span style="font-size: 10pt; color: blue;">Submit your request</span></u><span style="font-size: 10pt;"> <span style="color: rgb(153, 153, 153);">&lt;link to 2.2&gt; </span></span></div>
<div style="margin-left: 0.5in;">&nbsp;</div>
<div style="margin-left: 0.5in;"><span style="font-size: 10pt;">External URL<i>:</i></span></div>
<div style="margin-left: 0.5in;"><u><span style="font-size: 10pt; color: blue;">Read the Brain Traffic blog</span></u><span style="font-size: 10pt;"> <span style="color: rgb(153, 153, 153);">&lt;link to http://blog.braintraffic.com/&gt; </span></span></div>
<div>&nbsp;</div>
<div>&nbsp;<b><span style="font-size: 10pt;">Descriptive content labels</span></b></div>
<div><span style="font-size: 10pt;">If your copy isn&rsquo;t properly labeled within your content document, designers and developers working with the document can have a difficult time figuring out which copy goes where. </span></div>
<div>&nbsp;</div>
<div><span style="font-size: 10pt;">So, make sure to identify all the content pieces on each page. For example, put the label &quot;Heading&quot; above your page headline, &quot;Body copy&quot; above the main content, and &quot;Right column copy&quot; above content that lives on this part of the web page. Or use whatever labeling convention your agency or organization may already have established.</span></div>
<div>&nbsp;</div>
<div><i><span style="font-size: 10pt;">Example:</span></i></div>
<div>&nbsp;</div>
<div><a href="http://blog.braintraffic.com/wp-content/uploads/2010/02/ContentLabels.png"><img height="280" width="265" class="alignnone size-full wp-image-1010" title="ContentLabels" alt="" src="http://blog.braintraffic.com/wp-content/uploads/2010/02/ContentLabels.png" /></a></div>
<div><span style="font-size: 10pt;">The key is making sure the labels are clear and easy to understand for everyone referencing your document. </span></div>
<div>&nbsp;</div>
<div><b><span style="font-size: 10pt;">Dynamic content</span></b></div>
<div><span style="font-size: 10pt;">Content that may change or is dependent on functionality conditions is often referred to as &quot;dynamic&quot; content. For instance, if you&#8217;re working on a project that includes content that launches on different dates or should only be displayed based on certain requirements (maybe after a user logs in, for example), your document will need to specifically state when to display that content. </span></div>
<div>&nbsp;</div>
<div><span style="font-size: 10pt;">I recommend writing a short note to the developer above the specific piece of dynamic content. Describe the rule for displaying it&mdash;for example, &quot;only display this content for California residents.&quot; </span></div>
<div>&nbsp;</div>
<div><span style="font-size: 10pt;">I write these notes in gray text, so it&#8217;s easy for developers to skim and find them throughout the content document. </span></div>
<div>&nbsp;</div>
<div><span style="font-size: 10pt;"></p>
<div><i><span style="font-size: 10pt;">Example:</span></i></div>
<div><i>&nbsp;</i></div>
<div style="margin: 0in 0in 0.0001pt; text-indent: 0.5in;"><span style="color: rgb(153, 153, 153);">&lt;<b>Note to developers</b>: Display this link on 1/1/2010&gt;</span></div>
<div style="margin: 0in 0in 0.0001pt; text-indent: 0.5in;"><u><span style="color: blue;">See our 2010 plans</span></u><span style="color: rgb(153, 153, 153);">&lt;link to 3.4&gt; </span></div>
<div><b>&nbsp;</b></div>
<div><b><span style="font-size: 10pt;">Meta</span></b><b><span style="font-size: 10pt;"> data</span></b></div>
<div><span style="font-size: 10pt;">Those of you well-versed in web content know what meta data is, but let&#8217;s do a quick review. It refers to specific information developers need to make your content searchable. </span></div>
<div>&nbsp;</div>
<div><span style="font-size: 10pt;">Meta</span><span style="font-size: 10pt;"> data includes:</span></div>
<div>&nbsp;</div>
<div style="margin-left: 40.5pt; text-indent: -0.25in;"><span style="font-size: 10pt;">&middot;<span style="">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span><span style="font-size: 10pt;">Meta</span><span style="font-size: 10pt;"> title (the title of the content page, which appears in your internet browser)</span></div>
<div style="margin-left: 40.5pt; text-indent: -0.25in;"><span style="font-size: 10pt;">&middot;<span style="">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span><span style="font-size: 10pt;">Meta</span><span style="font-size: 10pt;"> description (a keyword-loaded description of the content page) </span></div>
<div style="margin-left: 40.5pt; text-indent: -0.25in;"><span style="font-size: 10pt;">&middot;<span style="">&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; </span></span><span style="font-size: 10pt;">Meta</span><span style="font-size: 10pt;"> keywords (words that refer to specific topics on the content page and make it easily findable) </span></div>
<div>&nbsp;</div>
<div><span style="font-size: 10pt;">A web writer or SEO expert is usually responsible for creating this information. Whether or not you create ityourself, you&#8217;ll need to include meta data in your content document. Which means you might also need to format this content, especially if you receive the meta data in a different type of document, like Microsoft Excel.</span></div>
<div>&nbsp;</div>
<div><span style="font-size: 10pt;">It&#8217;s a good idea to place the meta data in a separate section of your content &nbsp;document&mdash;say, at the top of each page&mdash;so it&#8217;s clearly distinguished from the actual web copy.</span></div>
<div>&nbsp;</div>
<div><i><span style="font-size: 10pt;">Example:</span></i></div>
<div><a href="http://blog.braintraffic.com/wp-content/uploads/2010/02/Metadata.png"><img class="alignnone size-full wp-image-1011" title="Metadata" alt="" src="http://blog.braintraffic.com/wp-content/uploads/2010/02/Metadata.png" style="width: 462px; height: 137px;" /></a></div>
<div><span style="font-size: 10pt;"></p>
<div><span style="font-size: 10pt;">Remember, the web content document you create isn&#8217;t just black-and-white. Sometimes it&rsquo;s blue. And underlined. With notes. Because that&#8217;s what works.</span></div>
<p></span></div>
<p></span></div>
]]></content:encoded>
			<wfw:commentRss>http://blog.braintraffic.com/2010/02/anatomy-of-a-web-content-document/feed/</wfw:commentRss>
		<slash:comments>5</slash:comments>
		</item>
		<item>
		<title>Links We Like</title>
		<link>http://blog.braintraffic.com/2009/02/links-we-like-3/</link>
		<comments>http://blog.braintraffic.com/2009/02/links-we-like-3/#comments</comments>
		<pubDate>Wed, 18 Feb 2009 17:00:50 +0000</pubDate>
		<dc:creator>Katie Dohman</dc:creator>
				<category><![CDATA[Content Strategy]]></category>
		<category><![CDATA[Editorial Strategy]]></category>
		<category><![CDATA[Style Guides and Such]]></category>
		<category><![CDATA[User Experience]]></category>
		<category><![CDATA[Web Writing]]></category>

		<guid isPermaLink="false">http://blog.braintraffic.com/2009/02/links-we-like-3/</guid>
		<description><![CDATA[Welcome to this week’s edition of links we like.
]]></description>
			<content:encoded><![CDATA[<p>Welcome to this week’s edition of links we like. Let’s get right to it, shall we? </p>
<p><a href="http://www.alistapart.com/articles/indefenseofreaders" target="_blank">In Defense of Readers</a><br />YES! Users want content, which means the design of readability is very important. This post on <a href="http://www.alistapart.com/" target="_blank">A List Apart</a> takes a careful, insightful look at how users read.&#0160; </p>
<p><a href="http://mashable.com/2009/02/17/firefox-productivity/" target="_blank">Make your Firefox work for you</a><br />We could all use some shortcuts, no?</p>
<p><a href="http://www.gavinwray.com/2009/02/planning-a-web-content-management-strategy/comment-page-1/" target="_blank">Mind-mapping content strategy</a><br />It’s the first we’ve seen.</p>
<p><a href="http://www.msnbc.msn.com/id/29224857/" target="_blank">SEO and survival</a> <br />We’d like to add that you also need a good content strategy.</p>
<p><a href="http://www.ragan.com/ME2/Audiences/dirmod.asp?sid=&amp;nm=&amp;type=MultiPublishing&amp;mod=PublishingTitles&amp;mid=5AA50C55146B4C8C98F903986BC02C56&amp;tier=4&amp;id=077F861A9EF940A482DA5C69F8D6F6C9&amp;AudID=3FF14703FD8C4AE98B9B4365B978201A" target="_blank">How One Little Letter Can Sabotage Your Meaning<br /></a>Editing still matters—spelling and grammar go a long way in helping readers understand your content. Even in the age of spell check, you must choose your words, and use your words, carefully.</p>
<p><a href="http://www.clickz.com/3632823" target="_blank">Social media secrets<br /></a>This <a href="http://www.clickz.com/" target="_blank">ClickZ</a> blog post, combined with a great <a href="http://www.mima.org/events/index.asp?eventID=168" target="_blank">MIMA event</a> today by Jeff Rohrs from ExactTarget, are good reminders that you aren’t in control when it comes to social media. And that’s a good thing. It means people are interacting with your content. And, well, isn’t that the point?</p>
]]></content:encoded>
			<wfw:commentRss>http://blog.braintraffic.com/2009/02/links-we-like-3/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Nitpicky Style Guide Item: The Internet is the internet</title>
		<link>http://blog.braintraffic.com/2009/02/nitpicky-style-guide-item-the-internet-is-the-internet/</link>
		<comments>http://blog.braintraffic.com/2009/02/nitpicky-style-guide-item-the-internet-is-the-internet/#comments</comments>
		<pubDate>Tue, 10 Feb 2009 15:43:18 +0000</pubDate>
		<dc:creator>Angie Halama</dc:creator>
				<category><![CDATA[Around the Office]]></category>
		<category><![CDATA[Editorial Strategy]]></category>
		<category><![CDATA[Style Guides and Such]]></category>
		<category><![CDATA[Web Writing]]></category>

		<guid isPermaLink="false">http://blog.braintraffic.com/2009/02/nitpicky-style-guide-item-the-internet-is-the-internet/</guid>
		<description><![CDATA[We writers have regular discussions about troubling words or troublesome tasks of cleaning up misunderstandings about capitalization, em dashes, and the like. Here's one of the latest, when we officially decided not to initial cap “internet” anymore, whether it’s used as a noun or an adjective.
]]></description>
			<content:encoded><![CDATA[<p>You may remember Kristina&#39;s post about <a href="http://braintraffic.typepad.com/braintraffic/2009/02/web-content-style-guides-that-dont-suck.html" target="_blank">style guides</a>. Style guides make writers happy because they can follow the rules the first time, and they make businesses happy because the writers are speaking the language. And hammering out style details at the beginning saves needless time and expense to clean up these small details at the end of a large&#0160;project.&#0160; </p>
<p>As such, we writers have regular discussions about troubling words or troublesome tasks of cleaning up misunderstandings about capitalization, em dashes, and the like. Here&#39;s one of the latest, when we officially decided not to initial cap “internet” anymore, whether it’s used as a noun or an adjective. </p>
<p>As I recall, the decision came about something like this:&#0160;&#0160;&#0160; </p>
<p>Angie 1.0 (me): Hey, everyone! Should we initial cap internet when we use it as a noun? </p>
<p>Angie 2.0: I don’t like capitalizing Internet. Or Web. Or InterWebs. </p>
<p>Katie: Yeah! I hate capping things. </p>
<p>Meghan: But didn’t we agree to initial cap “web” when we use it as a noun? </p>
<p>Angie 2.0: When did we agree to that? </p>
<p>Angie 1.0: Didn’t you get that email? </p>
<p>Meghan: <em>Wired</em> magazine doesn’t initial cap internet. And isn’t the rule about initial capping it in the process of changing? </p>
<p>Angie 2.0: And <em>Wired</em> is on the cutting edge of that change. </p>
<p>Angie 1.0: Right. Eventually nobody will initial cap internet. </p>
<p>Erin: Once the dictionaries catch up. </p>
<p>Meghan: Yes, let’s be on the cutting edge of change! </p>
<p>Everyone: <em>Yeah!</em> </p>
<p>Angie 1.0: Remember that movie <em>The Net</em> with Sandra Bullock? </p>
<p>Erin: Wasn’t that about identity theft on the internet? </p>
<p>Angie 2.0: Yeah, something like that. Do we have to initial cap “Net” when we use it as a noun? </p>
<p>Katie: We are NOT using “the Net.” Under any circumstances. </p>
<p>Everyone: <em>YEAH!</em></p>
<p>A quick perusal of a few industry blogs revealed an inconsistent style on initial capping internet. So we turned to <em>Wired</em> for some guidance. In 2004, it declared that on its pages internet and web (and net) would not be initial capped anymore. We’re happy to officially join the trend—since we believe it will become a rule anyway.&#0160; </p>
<p>It’s definitely becoming a rule in our house style guide. </p>
]]></content:encoded>
			<wfw:commentRss>http://blog.braintraffic.com/2009/02/nitpicky-style-guide-item-the-internet-is-the-internet/feed/</wfw:commentRss>
		<slash:comments>7</slash:comments>
		</item>
		<item>
		<title>Web Content Style Guides that Don&#8217;t Suck</title>
		<link>http://blog.braintraffic.com/2009/02/web-content-style-guides-that-dont-suck/</link>
		<comments>http://blog.braintraffic.com/2009/02/web-content-style-guides-that-dont-suck/#comments</comments>
		<pubDate>Mon, 02 Feb 2009 13:16:00 +0000</pubDate>
		<dc:creator>Kristina Halvorson</dc:creator>
				<category><![CDATA[Editorial Strategy]]></category>
		<category><![CDATA[Style Guides and Such]]></category>
		<category><![CDATA[Web Writing]]></category>

		<guid isPermaLink="false">http://blog.braintraffic.com/2009/02/web-content-style-guides-that-dont-suck/</guid>
		<description><![CDATA[The style guide is a long-overlooked tool in good content strategy. But style guides are a great investment for creating useful, usable content. Get some pointers here.
]]></description>
			<content:encoded><![CDATA[<p>I&#39;ve been writing content for websites for 11 years. </p>
<p>I&#39;ve worked on well over two hundred websites, maybe close to three hundred. </p>
<p>And how many times have I had a style guide to reference for a web content project?</p>
<p>Six.</p>
<p>Of those six style guides, exactly one of them was of any real use to me. (Thank you, <a href="http://www.medtronic.com" target="_blank">Medtronic</a>.)</p>
<p>Our brands are constantly evolving. New products are launched, old ones retired. Services expand and shift. Trademarks, usage, legal requirements . . . for some of us, it&#39;s a full-time job just to keep up with them.</p>
<p>No wonder, then, that our web content is always a few steps behind. Inaccurate, irrelevant, outdated, disorganized. </p>
<p><strong>How can you prevent crappy web content?</strong><br />You know what I&#39;m going to say, here. The most important thing you can do to ensure useful, usable online content is to create a <a href="http://www.braintraffic.com/what-we-do/web-content-strategy/" target="_blank">web content strategy.</a> </p>
<p>But the second most important thing? Invest in a web content style guide that&#39;s actually useful to the people who are creating, reviewing and approving your content.</p>
<p>In her indispensable guide to writing web content, <em><a href="http://www.amazon.com/o/ASIN/0123694868?pf_rd_m=ATVPDKIKX0DER&amp;pf_rd_s=center-2&amp;pf_rd_r=15P8V7Z7A4834P42N9QT&amp;pf_rd_t=101&amp;pf_rd_p=288448501&amp;pf_rd_i=507846" target="_blank">Letting Go of the Words,</a></em> Ginny Redish devotes an entire chapter to creating what she calls an &quot;organic&quot; web content style guide. Here are some highlights:</p>
<ul>
<li><strong>Start small.</strong> Let your style guide grow as issues and questions arise.</li>
<li><strong>Don&#39;t repeat the entire universe.</strong> There are dozens of great style guides out there for grammar and usage. Pick one, and point to it in yours.</li>
<li><strong>Focus on issues that keep coming up.</strong> Your web writers likely have the same questions over and over. Make a decision, record it, and move on.</li>
<li><strong>Put someone in charge.</strong> The style guide isn&#39;t going to update itself. Make sure someone owns it and is accountable for its accuracy, every day.</li>
<li><strong>Put it online.</strong>&#0160;This is a no-brainer. It&#39;s your most accessible, flexible, most cost-efficient option. In fact, a wiki might be a perfect option for your organization. Just make sure it has an owner to oversee its evolution.</li>
</ul>
<p><strong>Don&#39;t forget voice and tone.<br /></strong>I&#39;ll add one more pointer:</p>
<ul>
<li><strong>Demonstrate your brand voice and tone.</strong> I&#39;m always frustrated by brand guidelines that tell writers to be &quot;authentic,&quot; &quot;conversational,&quot; &quot;professional,&quot; &quot;friendly&quot;&#0160;. . . these words mean different things to different writers, and they&#39;re useless when you&#39;re simultaneously trying to communicate information that has to be helpful, compelling, actionable and scannable. So don&#39;t just describe voice and tone. Demonstrate it. Create a list of words to use, and words NOT to use. Show before and after edits. Point to other websites that capture the spirit of what you&#39;re after. </li>
</ul>
<p>Creating and managing web content is a complicated enough undertaking. Simplify the process with a style guide people will actually use.</p>
<p>Want help creating a web content style guide? Brain Traffic&#39;s expert team of web editors and writers would love to pitch in. <a href="http://www.braintraffic.com/contact-us/" target="_blank">Contact us.</a></p>
]]></content:encoded>
			<wfw:commentRss>http://blog.braintraffic.com/2009/02/web-content-style-guides-that-dont-suck/feed/</wfw:commentRss>
		<slash:comments>1</slash:comments>
		</item>
	</channel>
</rss>
