<?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>One Man's Walk in work &#187; writing</title>
	<atom:link href="http://onemanswalk.com/work/tag/writing/feed/" rel="self" type="application/rss+xml" />
	<link>http://onemanswalk.com/work</link>
	<description>jeremy lightsmith on agile, ruby, and consulting</description>
	<lastBuildDate>Wed, 04 May 2011 04:29:54 +0000</lastBuildDate>
	<generator>http://wordpress.org/?v=2.9.1</generator>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
			<item>
		<title>Effective Writing</title>
		<link>http://onemanswalk.com/work/2006/12/08/effective-writing/</link>
		<comments>http://onemanswalk.com/work/2006/12/08/effective-writing/#comments</comments>
		<pubDate>Fri, 08 Dec 2006 05:55:22 +0000</pubDate>
		<dc:creator>jeremy</dc:creator>
				<category><![CDATA[Uncategorized]]></category>
		<category><![CDATA[writing]]></category>

		<guid isPermaLink="false"></guid>
		<description><![CDATA[	Our publishers have given us a deadline of the end of the year to get 60 pages out for DSLs in Ruby.  That&#8217;s not a lot of time, but honestly probably a really great thing for us.  We needed the push.

	Putting everything else on hold for the month, I&#8217;ve found myself scrambling to [...]]]></description>
			<content:encoded><![CDATA[	<p>Our publishers have given us a deadline of the end of the year to get 60 pages out for <strong>DSLs in Ruby</strong>.  That&#8217;s not a lot of time, but honestly probably a really great thing for us.  We needed the push.</p>

	<p>Putting everything else on hold for the month, I&#8217;ve found myself scrambling to find a way to apply all the discipline that I have when programming to writing.   It&#8217;s hard, and getting started is always the hardest part.</p>

	<p>I&#8217;ve gone through many days of &#8220;working&#8221; yet getting nothing done.  This is what I&#8217;ve learned, it&#8217;s working for me, maybe it will work for you :<br />
&#8212;&#8212;<br />
h3. Work top down</p>

	<p>I remember outlining when I was writing papers in school.  I never particularly cared for it.  I could pretty much keep the structure of my paper in my head and just write from that.  Turns out that&#8217;s not actually true for a book.  And it&#8217;s even less true when you are writing a book with 4 authors in 3 different timezones.</p>

	<p>Get a loose outline for the whole book, and then as you write each chapter, outline that in detail.  Work on one chapter at a time.</p>

	<h3>Question Driven Writing</h3>

	<p>XP has <span class="caps">TDD</span> to keep you honest.  If it&#8217;s not making a test pass, you should delete it or write a test for it.</p>

	<p>In a similar way, why not start a chapter by writing the questions it should answer.  If you find yourself writing text that doesn&#8217;t answer one of those questions, delete it, or add the question.</p>

	<h3>Work in Sprints</h3>

	<p>I find I simply <span class="caps">CAN NOT</span> concentrate if I&#8217;m online and checking mail and talking to my roomates and answering IM&#8217;s&#8230;  As damaging as switching context is when I&#8217;m coding, it&#8217;s several times more damaging when I&#8217;m writing.</p>

	<p>The problem is that there&#8217;s always more to learn, so it&#8217;s way easy to get distracted.  Oh, Joe&#8217;s online, let&#8217;s see if he knows about declarative programming.  Let&#8217;s google for metaprogramming.  Let&#8217;s download rBehave.</p>

	<p>Even working on examples can be a rabbit hole.  And with no pair to pull me back to what we should be doing, I&#8217;ve wasted weeks on not important stuff.</p>

	<p>The solution?</p>

	<p>Figure out what needs to get done next.  Do some outlining or research or write some examples, whatever.  Once you&#8217;re confident that you have some material to write about, start a sprint.</p>

	<p>I&#8217;m using 2 hour increments, but I could probably do 3 or 4.</p>

	<ol>
		<li>Unplug the wifi, evdo or lan cable.</li>
			<li>Take a minute to think about what you&#8217;re about to do (call it a mini standup) tell someone if, say your girlfriend&#8217;s available</li>
			<li>Set your timer for 2 hours and write.</li>
	</ol>

	<p>The rules are you have to be making forward progress.  If you come up against any hurdles, want to ask someone a question, park it.  Write it down on a card or a &#8220;todo.txt&#8221; file.</p>

	<p>What do you do when you write?</p>

 ]]></content:encoded>
			<wfw:commentRss>http://onemanswalk.com/work/2006/12/08/effective-writing/feed/</wfw:commentRss>
		<slash:comments>1</slash:comments>
		</item>
	</channel>
</rss>

