<?xml version="1.0" encoding="UTF-8"?><rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	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/"
		>
<channel>
	<title>Comments on: Writing concise documents</title>
	<atom:link href="http://blog.mozilla.com/sumo/2009/04/09/writing-concise-documents/feed/" rel="self" type="application/rss+xml" />
	<link>http://blog.mozilla.com/sumo/2009/04/09/writing-concise-documents/</link>
	<description>The support.mozilla.com (SUMO) project blog</description>
	<lastBuildDate>Thu, 11 Mar 2010 21:43:16 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.9.2</generator>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
		<item>
		<title>By: Peter</title>
		<link>http://blog.mozilla.com/sumo/2009/04/09/writing-concise-documents/comment-page-1/#comment-20880</link>
		<dc:creator>Peter</dc:creator>
		<pubDate>Mon, 20 Apr 2009 08:56:55 +0000</pubDate>
		<guid isPermaLink="false">http://blog.mozilla.com/sumo/?p=552#comment-20880</guid>
		<description>The Illuimine website has a whole host of article around writing clearly and concisely, in my oppinion one of the best is this one linked below titled No Bull Less Fog. 
http://www.illumine.co.uk/blog/2008/11/no-bull-less-fog/</description>
		<content:encoded><![CDATA[<p>The Illuimine website has a whole host of article around writing clearly and concisely, in my oppinion one of the best is this one linked below titled No Bull Less Fog.<br />
<a href="http://www.illumine.co.uk/blog/2008/11/no-bull-less-fog/" rel="nofollow">http://www.illumine.co.uk/blog/2008/11/no-bull-less-fog/</a></p>
]]></content:encoded>
	</item>
	<item>
		<title>By: George</title>
		<link>http://blog.mozilla.com/sumo/2009/04/09/writing-concise-documents/comment-page-1/#comment-20567</link>
		<dc:creator>George</dc:creator>
		<pubDate>Wed, 15 Apr 2009 19:41:53 +0000</pubDate>
		<guid isPermaLink="false">http://blog.mozilla.com/sumo/?p=552#comment-20567</guid>
		<description>Your contribution on the issue of concise writing is very helpful.

I need some help. I have a lot of online research resources for a book project. Some of the material is saved on a word processor and the rest online on Favorites and Bookmarks. I want to digitally organize the material to facilitate the drafting of the book. What do I do? I am looking at Deli.cio.us, a Social Bookmarking application regarding this. Is it ok or there is a better way?</description>
		<content:encoded><![CDATA[<p>Your contribution on the issue of concise writing is very helpful.</p>
<p>I need some help. I have a lot of online research resources for a book project. Some of the material is saved on a word processor and the rest online on Favorites and Bookmarks. I want to digitally organize the material to facilitate the drafting of the book. What do I do? I am looking at Deli.cio.us, a Social Bookmarking application regarding this. Is it ok or there is a better way?</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Bo</title>
		<link>http://blog.mozilla.com/sumo/2009/04/09/writing-concise-documents/comment-page-1/#comment-20286</link>
		<dc:creator>Bo</dc:creator>
		<pubDate>Sun, 12 Apr 2009 04:57:08 +0000</pubDate>
		<guid isPermaLink="false">http://blog.mozilla.com/sumo/?p=552#comment-20286</guid>
		<description>This was my example, and I knew it was redundant - I was trying to make it really scary on purpose. Greg&#039;s grammatical comments are well taken, though.</description>
		<content:encoded><![CDATA[<p>This was my example, and I knew it was redundant &#8211; I was trying to make it really scary on purpose. Greg&#8217;s grammatical comments are well taken, though.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Majken "Lucy" Connor</title>
		<link>http://blog.mozilla.com/sumo/2009/04/09/writing-concise-documents/comment-page-1/#comment-20178</link>
		<dc:creator>Majken "Lucy" Connor</dc:creator>
		<pubDate>Fri, 10 Apr 2009 21:43:52 +0000</pubDate>
		<guid isPermaLink="false">http://blog.mozilla.com/sumo/?p=552#comment-20178</guid>
		<description>I agree with the spirit of this post, if not with the example cited.

We need to make sure articles are not only easy to read, but also easy to skim. Big chunks of text make it harder for the user to be confident they&#039;re at the right place and some may give up rather than trying to catch the gist.

However I think we do need to be careful not to go to the other extreme.  Words and information might be redundant, but they might be necessary context to make a sentence make sense. There&#039;s a real danger in assuming the user is correctly inferring from previous text.

For example, there&#039;s a reason this was in brackets - (saved passwords, cookies, and history) - because they&#039;re examples of the types of data. In the suggested change they become a proper list, which actually has an entirely different meaning.

I think a better way to shorten this information would be to drop the excess off the end: 

“It is possible to import settings and other user data (saved passwords, cookies, and history) from Flock into Firefox. This is an advanced operation, however, and it will replace Firefox’s existing data.&quot;</description>
		<content:encoded><![CDATA[<p>I agree with the spirit of this post, if not with the example cited.</p>
<p>We need to make sure articles are not only easy to read, but also easy to skim. Big chunks of text make it harder for the user to be confident they&#8217;re at the right place and some may give up rather than trying to catch the gist.</p>
<p>However I think we do need to be careful not to go to the other extreme.  Words and information might be redundant, but they might be necessary context to make a sentence make sense. There&#8217;s a real danger in assuming the user is correctly inferring from previous text.</p>
<p>For example, there&#8217;s a reason this was in brackets &#8211; (saved passwords, cookies, and history) &#8211; because they&#8217;re examples of the types of data. In the suggested change they become a proper list, which actually has an entirely different meaning.</p>
<p>I think a better way to shorten this information would be to drop the excess off the end: </p>
<p>“It is possible to import settings and other user data (saved passwords, cookies, and history) from Flock into Firefox. This is an advanced operation, however, and it will replace Firefox’s existing data.&#8221;</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Mossop</title>
		<link>http://blog.mozilla.com/sumo/2009/04/09/writing-concise-documents/comment-page-1/#comment-20080</link>
		<dc:creator>Mossop</dc:creator>
		<pubDate>Thu, 09 Apr 2009 20:39:11 +0000</pubDate>
		<guid isPermaLink="false">http://blog.mozilla.com/sumo/?p=552#comment-20080</guid>
		<description>Of course by removing the redundant information you are also reducing the keywords and terms for search engines like Google to use. This could drop the article lower in the search results for how to import data from Flock.</description>
		<content:encoded><![CDATA[<p>Of course by removing the redundant information you are also reducing the keywords and terms for search engines like Google to use. This could drop the article lower in the search results for how to import data from Flock.</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Chris Ilias</title>
		<link>http://blog.mozilla.com/sumo/2009/04/09/writing-concise-documents/comment-page-1/#comment-20076</link>
		<dc:creator>Chris Ilias</dc:creator>
		<pubDate>Thu, 09 Apr 2009 20:14:37 +0000</pubDate>
		<guid isPermaLink="false">http://blog.mozilla.com/sumo/?p=552#comment-20076</guid>
		<description>Thanks Greg! That&#039;s exactly what this post is about. Great feedback!</description>
		<content:encoded><![CDATA[<p>Thanks Greg! That&#8217;s exactly what this post is about. Great feedback!</p>
]]></content:encoded>
	</item>
	<item>
		<title>By: Greg K Nicholson</title>
		<link>http://blog.mozilla.com/sumo/2009/04/09/writing-concise-documents/comment-page-1/#comment-20074</link>
		<dc:creator>Greg K Nicholson</dc:creator>
		<pubDate>Thu, 09 Apr 2009 19:37:56 +0000</pubDate>
		<guid isPermaLink="false">http://blog.mozilla.com/sumo/?p=552#comment-20074</guid>
		<description>‘ “To import settings and other user data (saved passwords, cookies, and history), this is an advanced operation and will replace existing Firefox data.”

It’s the same message, but clearer and more succinct. ’

It&#039;s also nonsensical.

The part after the last comma seems to be a separate clause, which needs a semi-colon, a dash or a sentence-break before it. And the first part doesn&#039;t actually say anything.

You probably want to say:

“Importing settings, saved passwords, cookies, and history is an advanced operation that will replace existing Firefox data.”</description>
		<content:encoded><![CDATA[<p>‘ “To import settings and other user data (saved passwords, cookies, and history), this is an advanced operation and will replace existing Firefox data.”</p>
<p>It’s the same message, but clearer and more succinct. ’</p>
<p>It&#8217;s also nonsensical.</p>
<p>The part after the last comma seems to be a separate clause, which needs a semi-colon, a dash or a sentence-break before it. And the first part doesn&#8217;t actually say anything.</p>
<p>You probably want to say:</p>
<p>“Importing settings, saved passwords, cookies, and history is an advanced operation that will replace existing Firefox data.”</p>
]]></content:encoded>
	</item>
</channel>
</rss>
