<?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>MeganMcDermott.com&#187; Writing  &#8211; MeganMcDermott.com</title>
	<atom:link href="http://meganmcdermott.com/category/writing/feed/" rel="self" type="application/rss+xml" />
	<link>http://meganmcdermott.com</link>
	<description>Web design and that</description>
	<lastBuildDate>Mon, 26 Jul 2010 17:37:00 +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>Tutorials need to teach</title>
		<link>http://meganmcdermott.com/2008/05/23/tutorials-need-to-teach/</link>
		<comments>http://meganmcdermott.com/2008/05/23/tutorials-need-to-teach/#comments</comments>
		<pubDate>Fri, 23 May 2008 19:02:48 +0000</pubDate>
		<dc:creator>Megan</dc:creator>
				<category><![CDATA[Usability]]></category>
		<category><![CDATA[Writing]]></category>

		<guid isPermaLink="false">http://meganmcdermott.com/?p=233</guid>
		<description><![CDATA[I just came across a certain article on some drupal theming techniques that called itself a tutorial. What&#8217;s the problem? It didn&#8217;t actually teach (or tutor) anything. It simply gave you some code to copy and paste and told you where to paste it. How does that help? People aren&#8217;t going to learn if you just give them the [...]]]></description>
			<content:encoded><![CDATA[<p>I just came across a certain article on some drupal theming techniques that called itself a tutorial. What&#8217;s the problem? It didn&#8217;t actually <em>teach</em> (or tutor) anything. It simply gave you some code to copy and paste and told you where to paste it. How does that help?</p>
<p>People aren&#8217;t going to learn if you just give them the answers. This happens all the time in the <a href="http://webmaster-forums.net">forums</a> –people post a question and someone comes along and gives them the code to paste in. That solves the problem but the poster doesn&#8217;t learn anything in the process.</p>
<p>With coding questions in particular I&#8217;ll often give people most of the answer, even writing out a step-by-step tutorial, but I won&#8217;t post the full code or a link to a working page. This way the user has to put things together themselves and figure out how things work. There was a really great post at <a href="http://headrush.typepad.com/creating_passionate_users/archives.html">Creating Passionate Users</a> called <a href="http://headrush.typepad.com/creating_passionate_users/2006/11/cognitive_seduc.html">&#8220;Cognitive Seduction and the &#8220;peekaboo&#8221; law&#8221;</a>:</p>
<blockquote><p>In learning, the more you fill things in and hold the learner&#8217;s hand, the less their brain will engage. If they don&#8217;t need to fire a single neuron to walk through the tutorial, lesson, lecture, etc., they&#8217;re getting a shallow, surface-level, non-memorable exposure of &#8220;covered&#8221; material, but&#8230; what&#8217;s the point?</p></blockquote>
<p>(I totally love that blog. So sad that she&#8217;s no longer posting. It&#8217;s a must read if you&#8217;re interested in education and/or software development or something in between).</p>
<p>With the tutorial in question I came out with some samples of the code I would need to do something similar to what I really want to do. It doesn&#8217;t help me understand what those variables are doing and how I can use them in different ways. Not a tutorial.</p>
<p>See, it&#8217;s a short post for once. Aren&#8217;t you happy?</p>
]]></content:encoded>
			<wfw:commentRss>http://meganmcdermott.com/2008/05/23/tutorials-need-to-teach/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Intro Text: Cut the &#8220;Blah Blah Blah&#8221;</title>
		<link>http://meganmcdermott.com/2007/10/05/intro-text-cut-the-blah-blah-blah/</link>
		<comments>http://meganmcdermott.com/2007/10/05/intro-text-cut-the-blah-blah-blah/#comments</comments>
		<pubDate>Fri, 05 Oct 2007 15:14:23 +0000</pubDate>
		<dc:creator>Megan</dc:creator>
				<category><![CDATA[Writing]]></category>

		<guid isPermaLink="false">http://www.meganmcdermott.com/2007/10/05/intro-text-cut-the-blah-blah-blah/</guid>
		<description><![CDATA[In Jakob Nielsen&#8217;s AlertBox this week he talks about intro text. Specifically, &#8220;blah blah blah&#8221; intro text. You&#8217;ve probably seen it. That paragraph that rambles on about nothing. This happens all the time on web pages and it&#8217;s a particular indication of the lack of attention to good copy on the web. As Nielsen points [...]]]></description>
			<content:encoded><![CDATA[<p>In Jakob Nielsen&#8217;s <a href="http://www.useit.com/alertbox/intro-text.html">AlertBox</a> this week he talks about intro text. Specifically, &#8220;blah blah blah&#8221; intro text. You&#8217;ve probably seen it. That paragraph that rambles on about nothing. This happens all the time on web pages and it&#8217;s a particular indication of the lack of attention to good copy on the web. As Nielsen points out, users usually skip over this text and search for actionable items like bulleted lists, graphics, and links.</p>
<p><span id="more-190"></span></p>
<h3>Why the Filler Text</h3>
<p>Part of the reason why this happens is because we tend to think about design and architecture before content. Often designers will work with clients to define what pages are needed, then add the content later. A typical conversation might go like this:</p>
<p>Designer: We need some content for this page.<br />
Client: Oh, well can&#8217;t we just write something to put there?<br />
Designer: What should it say?<br />
Client: I don&#8217;t know, just make something up.</p>
<p>So someone writes a bunch of filler without thinking about why people are visiting this page and what they want from it. This is a particular problem on University websites, I&#8217;ve found. <a href="http://www.housing.uwaterloo.ca/meal_plans/index.html">This page</a> used to consist of only the first line under the graphic. Why? Because the content editor didn&#8217;t think about what the purpose of that page was. It was an intermediary page leading to more detailed information. The first thought might have been that it&#8217;s just a filler page, it doesn&#8217;t need to have any content. I developed some content that provides an introduction to the rest of that section. In my new job I&#8217;ll be responsible for <a href="http://www.uwaterloo.ca/alumni/index.php">this page</a> (and others like it!). </p>
<p>Of course, there&#8217;s also the SEO component &mdash; sometimes you&#8217;ll see filler text that is clearly there to provide keywords for search engines and not something that&#8217;s useful for human visitors.</p>
<h3>How to Fix your Copy </h3>
<p>This goes back to what I said about designers needing to <a href="http://www.meganmcdermott.com/2007/02/08/who-is-responsible-for-the-writing/">develop some writing skills</a>. Things like this happen because in most design projects there isn&#8217;t a dedicated copywriter.</p>
<p>As Nielsen says:</p>
<blockquote><p>So, prune your initial draft of marketese and focus on answering two questions: </p>
<ul>
<li>What? (What will users find on this page — i.e., what&#8217;s its function?) </li>
<li>Why? (Why should they care — i.e., what&#8217;s in it for them?)</li>
</ul>
</blockquote>
<p>I&#8217;d also like to go back to the 4 key home page usability questions raised by Steve Krug in <a href="http://www.amazon.com/Dont-Make-Me-Think-Usability/dp/0321344758/ref=pd_bbs_3/105-3645523-5994007?ie=UTF8&#038;s=books&#038;qid=1191596908&#038;sr=8-3"><em>Don&#8217;t Make Me Think!</em></a>. Users need to know:</p>
<ul>
<li>What is this? </li>
<li>What do they have here? </li>
<li>What can I do here? </li>
<li>Why should I be here &mdash; and not somewhere else?&#8221;</li>
</ul>
<p>Your intro text should help them to answer those questions. Then, think about how you can help them in reaching their destination (the information they are looking for). Check your stats to find out which pages are most visited by users. Use an analytics program to find out what the most common navigation paths are. If you know that users are going to need certain information, provide it for them immediately rather than expecting them to find the links to it. If you&#8217;re trying to sell something, use this area to persuade. </p>
<p>There are many options for otherwise empty, filler pages. Think about what users need and what the goal of the page should be. If the page doesn&#8217;t have a goal, then maybe there&#8217;s a way to eliminate it. </p>
]]></content:encoded>
			<wfw:commentRss>http://meganmcdermott.com/2007/10/05/intro-text-cut-the-blah-blah-blah/feed/</wfw:commentRss>
		<slash:comments>1</slash:comments>
		</item>
		<item>
		<title>Search Words vs. Company Words: My Post at YOUmoz</title>
		<link>http://meganmcdermott.com/2007/03/13/search-words-vs-corporate-words/</link>
		<comments>http://meganmcdermott.com/2007/03/13/search-words-vs-corporate-words/#comments</comments>
		<pubDate>Tue, 13 Mar 2007 09:19:54 +0000</pubDate>
		<dc:creator>Megan</dc:creator>
				<category><![CDATA[Marketing/SEO/Monetization]]></category>
		<category><![CDATA[Writing]]></category>

		<guid isPermaLink="false">http://www.meganmcdermott.com/2007/03/05/search-words-vs-corporate-words/</guid>
		<description><![CDATA[I had originally written this post for this site but I decided to try posting it at YouMoz instead. In case you&#8217;re not familiar with it, YOUmoz is the user-generated component of the SEOmoz site (my favourite search/marketing blog!). My article on search terms was posted today: Search Words vs. Company Words: Targeting Long-tail Searches [...]]]></description>
			<content:encoded><![CDATA[<p>I had originally written this post for this site but I decided to try posting it at YouMoz instead. In case you&#8217;re not familiar with it, YOUmoz is the user-generated component of the SEOmoz site (my favourite search/marketing blog!). My article on search terms was posted today:</p>
<p><a href="http://www.seomoz.org/ugc/search-words-vs-company-words-targeting-longtail-searches">Search Words vs. Company Words: Targeting Long-tail Searches</a></p>
<p>Enjoy!</p>
<p>P.S. My new laptop is here!! Well, it&#8217;s at home with Liam right now. I let him open it while I&#8217;m at work. Will post about that later <img src='http://meganmcdermott.com/wp-includes/images/smilies/icon_smile.gif' alt=':)' class='wp-smiley' /> </p>
]]></content:encoded>
			<wfw:commentRss>http://meganmcdermott.com/2007/03/13/search-words-vs-corporate-words/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>Who is Responsible for the Writing?</title>
		<link>http://meganmcdermott.com/2007/02/08/who-is-responsible-for-the-writing/</link>
		<comments>http://meganmcdermott.com/2007/02/08/who-is-responsible-for-the-writing/#comments</comments>
		<pubDate>Thu, 08 Feb 2007 17:05:49 +0000</pubDate>
		<dc:creator>Megan</dc:creator>
				<category><![CDATA[Writing]]></category>

		<guid isPermaLink="false">http://www.meganmcdermott.com/2007/02/08/who-is-responsible-for-the-writing/</guid>
		<description><![CDATA[I believe that good writing is really key to a good website. Great visual design, usability, mark-up, and SEO aren&#8217;t going to be nearly as effective if the writing is bad. However, this is something that falls through the cracks on a lot of websites. Ideally you&#8217;d have a copywriter or editor to take care [...]]]></description>
			<content:encoded><![CDATA[<p>I believe that good writing is really  <a href="/2006/10/18/environmentaldefenseorg-a-great-example-of-engaging-writing/">key to a good website</a>. Great visual design, usability, mark-up, and SEO aren&#8217;t going to be nearly as effective if the writing is bad. However, this is something that falls through the cracks on a lot of websites. Ideally you&#8217;d have a copywriter or editor to take care of all your writing needs, but most small projects don&#8217;t have the resources to hire a writer (if they even consider it in the first place).</p>
<p>So whose job is it then?<span id="more-116"></span></p>
<p>Most web designers rely on the clients to write the copy. They are the people who know about what they need to write, so this is usually the most logical choice. The problem is that a lot of business owners aren&#8217;t very good at writing. A lot of <em>people</em> aren&#8217;t very good at writing. The client turns up with terrible copy (2 months late, of course) and the web designer publishes it as-is.</p>
<p>Who else could do the writing? If you had a SEO or marketing specialist that person might be an appropriate choice. Marketers and SEO&#8217;s seem to have a better understanding of the importance of words. However, most small projects don&#8217;t have a budget for a dedicated writer or SEO anyway, and those tasks often fall to the web designer.</p>
<p>Who&#8217;s left?<strong> The web designer.</strong> If no one else is able to write good copy, then the web designer should be able to offer that service, or at least connect the client with someone who can.</p>
<p>In my current position, I do the final copy editing. If someone needs something posted on the website they either give me some preliminary copy or just tell me what it needs to say. Then I edit it according to established web writing theory and my own expertise. I happen to be pretty good at writing &#8211; a lot web designers aren&#8217;t. But they should be <img src='http://meganmcdermott.com/wp-includes/images/smilies/icon_smile.gif' alt=':)' class='wp-smiley' /> </p>
<p>If you are interested in writing, <a href="http://www.37signals.com/svn/">Signal vs. Noise</a> and <a href="http://www.copyblogger.com/">Copyblogger</a> are good sites to visit. My #1 tip: <strong>the best way to get better at writing is to <em>read</em>.</strong></p>
]]></content:encoded>
			<wfw:commentRss>http://meganmcdermott.com/2007/02/08/who-is-responsible-for-the-writing/feed/</wfw:commentRss>
		<slash:comments>4</slash:comments>
		</item>
		<item>
		<title>Search Words vs. Marketing Words</title>
		<link>http://meganmcdermott.com/2007/01/26/search-words-vs-marketing-words/</link>
		<comments>http://meganmcdermott.com/2007/01/26/search-words-vs-marketing-words/#comments</comments>
		<pubDate>Fri, 26 Jan 2007 19:43:31 +0000</pubDate>
		<dc:creator>Megan</dc:creator>
				<category><![CDATA[Marketing/SEO/Monetization]]></category>
		<category><![CDATA[Writing]]></category>

		<guid isPermaLink="false">http://www.meganmcdermott.com/2007/01/26/search-words-vs-marketing-words/</guid>
		<description><![CDATA[Gerry McGovern had an interesting article the other day about the difference between search words and marketing words: The words that people search with may not always be the words they would like to read when they arrive at a webpage. The word &#8220;cheap&#8221; is a good example here. You probably don&#8217;t want to brand [...]]]></description>
			<content:encoded><![CDATA[<p>Gerry McGovern had an interesting article the other day about the difference between <a HREF="http://www.gerrymcgovern.com/nt/2007/nt-2007-01-22-words-that-work.htm">search words and marketing words</a>:</p>
<blockquote><p>The words that people search with may not always be the words they would like to read when they arrive at a webpage.</p></blockquote>
<p>The word &#8220;cheap&#8221; is a good example here. You probably don&#8217;t want to brand yourself as &#8220;cheap&#8221;. &#8220;Cheap&#8221; brings connotations of poor quality and bad service &#8211; something you probably want to avoid. Words  like &#8220;affordable&#8221; or &#8220;low-cost&#8221; would be more more appropriate. But you can bet that people will be using the word &#8220;cheap&#8221; when they search for sites like yours.</p>
<p>Mr. McGovern, unfortunately, stops just when the idea starts to get interesting. <span id="more-109"></span>You want to show people the nicer sounding words, but in order to rank for the search terms people will actually be using you need a way to show the simpler, cruder words to search engines. How do you develop a site that shows one set of words to people and another set of words to bots?</p>
<p>It&#8217;s a difficult problem. Google <em>does not</em> want you to show them different words from what they show to people. But, at the same time, they want to find the best results in their rankings. Or course, we all know that meta keywords are obsolete and underhanded methods such as hidden keywords are ignored. You could try to use off-page factors to target the simpler words but that is still branding yourself in a way you don&#8217;t want to be percieved.</p>
<p>It&#8217;s an interesting thing to think about, and I&#8217;m sure people who actually know about SEO would have more to say about it. One potential solution would be for search engines to be able to match what people enter with the words that marketers are using on the websites. So if someone entered &#8220;used car&#8221;, Google would know that this is the same as &#8220;pre-owned vehicle.&#8221; They already have spell checking functionality, so why not a thesaurus too?</p>
<p>Liam had another suggestion: rely on off-site directories and such to drive traffic to your site. So you get listed on sites that list &#8220;cheap web design&#8221; or whatever you&#8217;re selling, but do not include those words on your site. Liam also thinks that there&#8217;s no need to use the &#8220;nicer&#8221; words in the first place &#8211; just use the &#8220;crude&#8221; words to begin with. I&#8217;m not so sure about that: I think it&#8217;s very possible that people will react better to the nice words, depending on what you&#8217;re selling and who your audience is.</p>
<p>P.S. <a HREF="http://wordpress.org/development/2007/01/ella-21/">WordPress 2.1</a> is out and the new visual editor includes &#8211; you guessed it &#8211; spell check! Yay! I hope that editor works in Opera. I haven&#8217;t been using it because it didn&#8217;t work properly for me before.</p>
]]></content:encoded>
			<wfw:commentRss>http://meganmcdermott.com/2007/01/26/search-words-vs-marketing-words/feed/</wfw:commentRss>
		<slash:comments>5</slash:comments>
		</item>
		<item>
		<title>Writing for an International Audience</title>
		<link>http://meganmcdermott.com/2006/08/29/writing-for-an-international-audience/</link>
		<comments>http://meganmcdermott.com/2006/08/29/writing-for-an-international-audience/#comments</comments>
		<pubDate>Tue, 29 Aug 2006 20:45:02 +0000</pubDate>
		<dc:creator>Megan</dc:creator>
				<category><![CDATA[Writing]]></category>

		<guid isPermaLink="false">http://www.meganjack.com/?p=69</guid>
		<description><![CDATA[I just came across an interesting article about writing for an international audience. There are some eye opening points in this article. It&#8217;s sort of obvious that EFL (English as a foreign language) people will have problems with ambiguous terms and colloquialisms. What I hadn&#8217;t thought of is that long sentences and complex grammar also [...]]]></description>
			<content:encoded><![CDATA[<p>I just came across an interesting article about <a href="http://www.webpagecontent.com/arc_archive/139/5/">writing for an international audience</a>. There are some eye opening points in this article. It&#8217;s sort of obvious that EFL (English as a foreign language) people will have problems with ambiguous terms and <a href="http://www.peevish.co.uk/slang/">colloquialisms</a>. What I hadn&#8217;t thought of is that long sentences and complex grammar also confusing. </p>
<p>The article also points out some problems encountered by people who learned to read using a non-latin alphabet (such as native Chinese or Russian speakers). This means that text needs to be very clear and easy to read &#8211; short line lengths, good spacing, reasonable font size, and no funky fonts.</p>
<p>I didn&#8217;t realize that there were so many <a href="http://www.gray-area.org/Research/Ambig/">ways to be ambiguous</a> in the English language!</p>
]]></content:encoded>
			<wfw:commentRss>http://meganmcdermott.com/2006/08/29/writing-for-an-international-audience/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss>
