<?xml version="1.0" encoding="utf-8"?><feed xmlns="http://www.w3.org/2005/Atom" ><generator uri="https://jekyllrb.com/" version="4.3.4">Jekyll</generator><link href="https://monodot.co.uk/feed.xml" rel="self" type="application/atom+xml" /><link href="https://monodot.co.uk/" rel="alternate" type="text/html" /><updated>2026-11-11T11:32:11+00:00</updated><id>https://monodot.co.uk/feed.xml</id><title type="html">Tom Donohue</title><subtitle>Tom Donohue&apos;s blog. Staff Field Engineer at Grafana Labs, writing about observability and building small, useful apps.
</subtitle><author><name>Tom Donohue</name></author><entry><title type="html">Unexpected item in bagging area</title><link href="https://monodot.co.uk/unexpected-item-in-bagging-area/" rel="alternate" type="text/html" title="Unexpected item in bagging area" /><published>2026-11-01T00:00:00+00:00</published><updated>2026-11-01T00:00:00+00:00</updated><id>https://monodot.co.uk/unexpected-item-in-bagging-area</id><content type="html" xml:base="https://monodot.co.uk/unexpected-item-in-bagging-area/"><![CDATA[<p>This weekend, I wanted to do a little bit of work on one of my pet projects, <a href="https://apoll.app">apoll.app</a>.</p>

<p>I wanted to get Claude to refresh the design, and lay the groundwork for some new features. It was a Saturday and I had the whole day ahead of me.</p>

<p>But I realised that I had run out of milk for cereal. Nothing can happen before cereal.</p>

<p>I figured I would start Claude on the task anyway, while I succumbed to my hunger. I stood up from my desk, headed out into the real world and walked to the supermarket, a short distance away.</p>

<p>While I was out, Claude sent a message to my phone with a request for clarification.</p>

<p><em>“Do you want the URL to be /new/question or /new/qa?”</em></p>

<p>I opened my phone, responded to the request with a tap, and carried on with my shopping. As I approached the queue for the self-checkouts, it buzzed again:</p>

<p><em>“Which of these styles suits your preference? Swiss/modernist, minimal/tech, functional…“</em> <sup id="fnref:1" role="doc-noteref"><a href="#fn:1" class="footnote" rel="footnote">1</a></sup></p>

<h2 id="it-follows">It follows</h2>

<p>Isn’t this all just a bit… weird?</p>

<p>With a £20 subscription, I have a sidekick, available 24x7. It wants to help with everything.</p>

<p>Stepping away from your computer used to mean terminating all work in-flight. You could always kick off a long build and walk away. A build could never tap you on the shoulder in the checkout queue.</p>

<p>But now, your sidekick can follow you around – in the supermarket, on the train, or even at the pub.</p>

<p>Now, admittedly, I <em>choose</em> to install the Claude app, I <em>choose</em> to enable notifications and I <em>choose</em> to respond to them. But that dopamine hit of completing a task is somewhat difficult to resist.</p>

<p>I’m not sure yet if having a persistent sidekick is a gift for human productivity, or if it’s just another leash. <a href="https://en.wikipedia.org/wiki/Jevons_paradox">Jevons paradox</a> seems to be happening not in a factory in the 1800s, but in my pocket. The easier the work becomes, the more of it I willingly end up doing.</p>

<p>Meanwhile, as Claude was churning away at the next task, I was having to balance a bottle of milk, a newspaper and several other items on those miniature self-checkout scales. Not sure Claude can handle that task, yet.</p>

<div class="footnotes" role="doc-endnotes">
  <ol>
    <li id="fn:1" role="doc-endnote">
      <p>I chose the ‘Swiss/modernist’ style, by the way. Very nice. <a href="#fnref:1" class="reversefootnote" role="doc-backlink">&#8617;</a></p>
    </li>
  </ol>
</div>]]></content><author><name>Tom Donohue</name></author><summary type="html"><![CDATA[This weekend, I wanted to do a little bit of work on one of my pet projects, apoll.app.]]></summary><media:thumbnail xmlns:media="http://search.yahoo.com/mrss/" url="https://monodot.co.uk/assets/img/claude-checkout.png" /><media:content medium="image" url="https://monodot.co.uk/assets/img/claude-checkout.png" xmlns:media="http://search.yahoo.com/mrss/" /></entry><entry><title type="html">Making editing static sites easier</title><link href="https://monodot.co.uk/static-sites-pages-cms/" rel="alternate" type="text/html" title="Making editing static sites easier" /><published>2024-11-02T00:00:00+00:00</published><updated>2024-11-02T00:00:00+00:00</updated><id>https://monodot.co.uk/static-sites-pages-cms</id><content type="html" xml:base="https://monodot.co.uk/static-sites-pages-cms/"><![CDATA[<p>Recently I’ve been trying to drum up the enthusiasm for tidying up and overhauling my current <a href="https://www.tutorialworks.com">heap</a> of <a href="https://tomd.xyz">static</a> <a href="/">sites</a>.</p>

<p>I don’t update these websites very often. They usually start out with a bang and a flurry of activity. But some of them haven’t been updated in over 2 years.</p>

<p>Why haven’t I updated them? It might be because they are static websites. This method of building blogs comes with some serious technical baggage. It’s not for the faint-hearted. Static sites usually need to be updated with a code editor, and then the changes pushed up to <a href="https://github.com/monodot/monodot-co-uk">a Git repository</a>.</p>

<p>That’s fine when I’m learning new things. I can spend all day learning something new.</p>

<p>But once the site is set up, and when I spend all day in a code editor at work, the thought of spending <em>even more time</em> in a code editor to produce my “creative output” feels like a bit of a slog.</p>

<p>So this week, I wondered: should I install a full CMS like <a href="https://ghost.org/">Ghost</a> on these sites? Would that make the writing and editing process easier?</p>

<p>And so, I went into the weeds of how to deploy Ghost. I discovered a tool called Coolify which gives <a href="https://coolify.io/docs/services/ghost">one-click deployment of Ghost onto a VPS</a>. Neat, I thought. So I spun up a VPS in Hetzner, I tried it out, and thought Ghost felt OK. The sites look great, and the experience is pretty cool.</p>

<p>But I was still pretty unimpressed with the post editor. It looked fancy and all, but it’s not suitable for blogs that talk about code, at all. It’s clearly designed for proper <strong><em>writers</em></strong>.</p>

<p>So, clicking around Hacker News, as I usually do when looking for a bit of inspiration from my peers, I stumbled upon <a href="https://pagescms.org/">Pages CMS</a>. Pages CMS is an open source, web-based content editor for static sites, just like this one. This site is built with Jekyll, but Pages CMS also supports Next.js, Astro, Hugo and others.</p>

<p>I’m really impressed with it so far. It was incredibly easy it was to set up, and I really like the fact that I can self-host it, if I wish.</p>

<p>I’m going to install it on some of my other sites and see how easy it is to get the writing bug back again.</p>

<p>And who knows, maybe you might see more blog posts here soon!</p>]]></content><author><name>Tom Donohue</name></author><summary type="html"><![CDATA[Recently I’ve been trying to drum up the enthusiasm for tidying up and overhauling my current heap of static sites.]]></summary></entry><entry><title type="html">Facebook/WhatsApp: Consumers have no choice</title><link href="https://monodot.co.uk/facebook-whatsapp/" rel="alternate" type="text/html" title="Facebook/WhatsApp: Consumers have no choice" /><published>2021-01-08T10:00:00+00:00</published><updated>2021-01-08T10:00:00+00:00</updated><id>https://monodot.co.uk/facebook-whatsapp</id><content type="html" xml:base="https://monodot.co.uk/facebook-whatsapp/"><![CDATA[<p><a href="https://arstechnica.com/tech-policy/2021/01/whatsapp-users-must-share-their-data-with-facebook-or-stop-using-the-app/">Facebook is making another grab for my data</a>, this time through WhatsApp.</p>

<p>The valuable data in my phone book, my connections, location, social interactions and more, are all ripe for the taking.</p>

<p>I can either give Facebook permission to do this, or I can decline, and stop using the app.</p>

<p>If I decline, I’ll be locked out of conversations with friends and family, some conversations stretching back many years.</p>

<hr />

<p>Some people suggest moving to a privacy-focused messaging app, like Signal.</p>

<p><strong>The problem is: I now have to convince <em>all</em> of my friends to do the same.</strong></p>

<p>My friends don’t share all the same views as me. (This is a good thing.)</p>

<p>But if I have personal concerns about privacy, and I still want to keep in contact with friends and family, I have no choice but to use these apps.</p>

<p>I have caved in, and accepted the new terms of service.</p>

<hr />

<p>The market, given free rein, has failed.</p>

<p>Online communication tools are not a choice any more. They are a utility, used by billions, and need to be treated as such.</p>

<p>Telephony is regulated. I have the choice to move my phone number between providers. I can phone any other phone number, even if it’s on a different network.</p>

<p>So why aren’t the same freedoms guaranteed with online communications?</p>]]></content><author><name>Tom Donohue</name></author><summary type="html"><![CDATA[The slow, continuing death-ramp of consumer privacy]]></summary></entry><entry><title type="html">Beau Travail / Djibouti</title><link href="https://monodot.co.uk/beau-travail-djibouti/" rel="alternate" type="text/html" title="Beau Travail / Djibouti" /><published>2019-06-30T10:00:00+00:00</published><updated>2019-06-30T10:00:00+00:00</updated><id>https://monodot.co.uk/beau-travail-djibouti</id><content type="html" xml:base="https://monodot.co.uk/beau-travail-djibouti/"><![CDATA[<p>I don’t really have much of a desire to join the French Foreign Legion.</p>

<p>But after watching Clare Denis’s film <strong>Beau Travail</strong>, I might add Djibouti to my bucket list.</p>

<p>I don’t know anything about the country, but the movie was filmed on location there, and there are some great shots of the country. This part of the country looks pretty bleak, at least:</p>

<p><img src="/assets/img/beautravail1.jpg" alt="Beau Travail shot 1" /></p>

<p><img src="/assets/img/beautravail2.jpg" alt="Beau Travail shot 2" /></p>

<p><img src="/assets/img/beautravail4.jpg" alt="Beau Travail shot 4" /></p>

<p>And some extreme ironing:</p>

<p><img src="/assets/img/beautravail3.jpg" alt="Beau Travail shot 3" /></p>

<p>I do like getting to watch very obscure films on Mubi. Stuff I would never normally know about, or hunt down. Glad I made the effort with this one.</p>]]></content><author><name>Tom Donohue</name></author><summary type="html"><![CDATA[A bleak look into the Foreign Legion]]></summary></entry><entry><title type="html">Google’s lost my blog</title><link href="https://monodot.co.uk/google-wheres-my-site/" rel="alternate" type="text/html" title="Google’s lost my blog" /><published>2019-06-12T10:00:00+00:00</published><updated>2019-06-12T10:00:00+00:00</updated><id>https://monodot.co.uk/google-wheres-my-site</id><content type="html" xml:base="https://monodot.co.uk/google-wheres-my-site/"><![CDATA[<p>Last month I moved my main developer blog from <em>cleverbuilder.com</em> to <a href="https://tomd.xyz">tomd.xyz</a>. And somehow I seem to have lost most of my traffic. Oops.</p>

<p>I decided to move URL, because I want to give my developer blog a more personal feel.</p>

<p>I want to give my blog a simple identity that bears more relation to me as the author, rather than some random brand, <em>Clever Builder</em>, which sounded a bit corporate and doesn’t really reflect where I am in 2019.</p>

<p>What a disaster so far. In Google Search Console, my site’s search appearances and clicks have plummeted. Overnight, my visitors went <strong>from about 600 per day, to almost zero</strong>.</p>

<p>I went through <a href="https://support.google.com/webmasters/answer/9079473?hl=en">Google’s recommended actions</a> in the event of a traffic drop. I feared that maybe I’d been penalised for switching URLs. But I don’t think I’ve done anything wrong, and there are no manual actions listed inside Search Console.</p>

<p>So I’m stumped. This has been continuing for about two weeks.</p>

<p>At the moment I’m not sure what to do, but I’ll wait a couple of weeks more, to see if it’s just a blip.</p>

<p>Thank god this isn’t how I make a living! This has made me realise that being solely at the mercy of Google for your traffic (and income) must be a very precarious place to be.</p>

<p>Fingers crossed I get my lovely visitors back soon…</p>

<p>In the meantime, here’s my most recent article I published on the site: <a href="https://tomd.xyz/articles/openshift-s2i-example/">S2I builds in OpenShift - an example with Java and Maven</a></p>]]></content><author><name>Tom Donohue</name></author><summary type="html"><![CDATA[TIFU by changing my site URL and losing all my visitors]]></summary></entry><entry><title type="html">Quarterly Review: 2018 Q4</title><link href="https://monodot.co.uk/review-2018-q4/" rel="alternate" type="text/html" title="Quarterly Review: 2018 Q4" /><published>2019-01-20T10:00:00+00:00</published><updated>2019-01-20T10:00:00+00:00</updated><id>https://monodot.co.uk/review-2018-q4</id><content type="html" xml:base="https://monodot.co.uk/review-2018-q4/"><![CDATA[<p>Here’s my final quarterly review of 2018, and a quick look at 2019.</p>

<p>If you’re eagle-eyed, you’ll notice that there wasn’t a Q3 review. I’ll explain why later.</p>

<p>My current side projects are:</p>

<ul>
  <li>
    <p><a href="https://cleverbuilder.com">Clever Builder</a> - articles on programming, mostly Java, and more specifically around <a href="http://camel.apache.org">Apache Camel</a>.</p>
  </li>
  <li>
    <p><a href="https://cleverbuilder.com/camelstepbystep">Camel Step-by-Step</a> - a book I’ve been writing, on Apache Camel for beginners.</p>
  </li>
  <li>
    <p><a href="http://flat.haus">Flat Haus</a> - a small home decor website and <a href="https://instagram.com/flat.haus">Instagram account</a> - I’m not doing much with this site at the moment, as I don’t have the time.</p>
  </li>
</ul>

<h2 id="clever-builder">Clever Builder</h2>

<p>User numbers for Clever Builder rose to 19,564 - not much of an increase, but that’s because I didn’t really add any major new content to the site, and didn’t improve existing content either:</p>

<p><img src="https://monodot.co.uk/assets/img/quarterly-2018q4-audience.png" alt="Clever Builder 2018 Q4 stats" /></p>

<p>This quarter, I wrote <strong>one</strong> new article. Yes, just one article:</p>

<ul>
  <li>
    <p><a href="https://cleverbuilder.com/notes/jboss-mdb-custom-resource-adapter/">JBoss/Wildfly: Setting a custom resource adapter for an MDB</a></p>
  </li>
  <li>
    <p>(crickets…)</p>
  </li>
</ul>

<p>This one article was just a quick braindump of things I found out when I went to see a customer.</p>

<p>Other than that, I found it really hard to find any time to update the website.</p>

<h2 id="thoughts">Thoughts</h2>

<p><strong>Having no time</strong></p>

<p>I was pretty busy in the second half of this year. Work got busier, and with more travelling involved.</p>

<p>I had a few weekend breaks with some amazing friends.</p>

<p>As a result of both, I was flying almost every week.</p>

<p>That used up a lot of my energy, and I felt I had less drive to write articles, or even work on the book.</p>

<p>If I’m spending all week travelling and working intensely on a computer, I just don’t want to stare at a laptop screen on Saturdays and Sundays.</p>

<p>I managed 1 blog post on Clever Builder, and even that was a really quick write-up of some rough notes I’d had!</p>

<p>I also didn’t write a quarterly review on this site either.</p>

<p>Lesson learned: travelling and side projects don’t mix easily!</p>

<p><strong>Delaying launching</strong></p>

<p>I originally slated <a href="https://cleverbuilder.com/camelstepbystep">Camel Step-by-Step</a> for completion towards the end of Summer 2018 – and by this, I was meaning around August.</p>

<p>But this date slipped… a lot!</p>

<p>The book is meant to be a general guide to Apache Camel for beginners, but defining the boundaries of what a beginner needs to know is very difficult. This means it’s hard to know when the book is “finished”.</p>

<p>So I kept adding more chapters to the book, and then I started to produce some bonus content (six sample Camel applications).</p>

<p>I’m satisfied with the book now, but I know in future that I need to be more strict on knowing when a project is “done”. Scope creep is even a real thing on personal projects.</p>

<h2 id="reading-list">Reading list</h2>

<p>I read more books in 2018 than I probably have in the previous 5 years combined. My highlights this quarter were:</p>

<ul>
  <li>
    <p><strong>Anything You Want by Derek Sivers</strong> - an excellent guide to how Derek Sivers started and grew <em>CD Baby</em>. It’s such a tiny wee book but packed full of useful stuff about how to create what people want.</p>
  </li>
  <li>
    <p><strong>Do Open by David Hieatt</strong> - a great book on starting and growing an email newsletter.</p>
  </li>
  <li>
    <p><strong>The One Thing by Jay Papasan</strong> - one of those motivational books that are a bit of an enjoyable waste of time. The takeaway message: just focus on one thing, rather than flitting about between different things. (At least, I think that was the message!)</p>
  </li>
</ul>

<h2 id="goals-for-2019">Goals for 2019</h2>

<p>This year has been a big experiment for me. I’ve written a book and released it into the world. YIKES.</p>

<p>I’ve learned so much. I know for sure that I don’t want to work on another book just yet.</p>

<p>In 2019 I’m not currently planning to launch anything major. I just want to continue to grow <a href="https://cleverbuilder.com">Clever Builder</a>, and concentrate on creating useful stuff for people.</p>

<hr />

<p>Thanks for reading this quarterly review! I hope you found it interesting. If you have any comments, or if you’d like to know more, let me know in the comments below.</p>]]></content><author><name>Tom Donohue</name></author><summary type="html"><![CDATA[My review of the fourth quarter of 2018, including a wrap-up of 2018]]></summary></entry><entry><title type="html">What I’ve learned while writing my first book</title><link href="https://monodot.co.uk/learned/" rel="alternate" type="text/html" title="What I’ve learned while writing my first book" /><published>2018-08-27T10:00:00+00:00</published><updated>2018-08-27T10:00:00+00:00</updated><id>https://monodot.co.uk/learned</id><content type="html" xml:base="https://monodot.co.uk/learned/"><![CDATA[<p>This is the story of what I’ve learned so far whilst writing my first book, <a href="https://cleverbuilder.com/camelstepbystep">Camel Step-by-Step</a>.</p>

<figure>
  <img src="https://monodot.co.uk/assets/img/white-wall.jpg" alt="The blank canvas" />
  
    <figcaption><i>The blank canvas
</i></figcaption>
  
</figure>

<p>In March I started writing my first book. So far, the experience has been pretty enlightening, both on a personal and a technical level.</p>

<p>I feel like writing has helped me to learn quite a few things; although I never expected it when I first started the project.</p>

<p>I’m nearing the end of writing now, and I wanted to write this post to take stock, and document what I’ve learned so far.</p>

<h2 id="how-it-began">How it began</h2>

<p>To tell the complete story of what I’ve learned, I need to start at the beginning.</p>

<p>Creating a product is something I’ve wanted to do for a long time.</p>

<p>I’m a bit of an introvert, so writing a book was the first thing I thought of. Writing a book allows me to share knowledge and help other people (whilst at the same time hiding behind a computer screen ;-) ).</p>

<p>So, I started out in March. I picked a topic – the Java framework <a href="http://camel.apache.org/">Apache Camel</a>. I’ve already been blogging about it for a couple of years, so it seemed like a good choice. I threw together a rough book outline and a landing page, in one weekend.</p>

<figure>
  <img src="https://monodot.co.uk/assets/img/camelsbs-landing.png" alt="Camel Step-by-Step landing page" />
  
    <figcaption><i>Camel Step-by-Step landing page
</i></figcaption>
  
</figure>

<p>The outline was mostly a guess, based on:</p>

<ul>
  <li>questions I get asked</li>
  <li>things I wish I’d known when I first started</li>
  <li>the topics of my most popular blog posts.</li>
</ul>

<p>I stuck a <em>pre-order now</em> button at the bottom of the page, and made a start on writing the first draft.</p>

<h2 id="the-difficult-first-book">The ‘difficult’ first book</h2>

<p>I already acknowledged in a <a href="/writing-a-book/">previous post that creating is hard</a>.</p>

<p>But the first thing I discovered is that writing your first book is <strong>hard x 1,000</strong>.</p>

<p>I thought that in writing a technical book, it would just be a matter of documenting the things I know, and the book would easily come together.</p>

<p>But the truth is that writing is only half of the work - especially when writing a technical book.</p>

<p>There are many other things to think of - such as devising appropriate examples, writing sample code, and thinking about structure - these take up a lot of time.</p>

<p><strong>Takeaway:</strong> Creating a book takes time.</p>

<h2 id="writing-slowly">Writing, slowly</h2>

<p>Writing a book takes an unbelievable amount of time! Creating an app would have been quicker. 😂</p>

<p>Since March, I’ve built up the book content rather more slowly than I expected. Today, I just hit 25,000 words.</p>

<p>That means that over 5 months, I’ve averaged 5,000 words per month.</p>

<p>That’s not particularly fast, but I have improved somewhat since the beginning.</p>

<p>I’ve seen the biggest improvement most recently, as I’ve started making time to write in the mornings before work. I’m now making bigger strides than I have done previously.</p>

<p>I used to read blog posts from people claiming that they can write thousands of words in a day. I believed them for a while. Now I don’t really.</p>

<p><strong>Takeaway:</strong> Writing is slow. That’s it.</p>

<h2 id="nobody-tells-you-where-to-stop-the-ever-growing-quiche">Nobody tells you where to stop (the ever-growing quiche)</h2>

<p>When you’re writing a non-fiction book, how do you know where to stop? I could write about my topic for months and months… and still not be finished.</p>

<p>I created an outline of the book, and I published a landing page before I even started writing. Yet I’m still adding chapters to the book which I didn’t expect I would be writing. Why is that?</p>

<p>I see the process of writing a technical book as a giant quiche:</p>

<figure>
  <img src="https://monodot.co.uk/assets/img/quiche.jpg" alt="The quiche of writing a technical book" />
  
    <figcaption><i>The quiche of writing a technical book
</i></figcaption>
  
</figure>

<p>At the <strong>edges of the quiche</strong> are the most <strong>advanced and complicated topics</strong> that I want to write about. In the centre is the <strong>core knowledge</strong> - the basics that need to be explained before the advanced stuff can be understood.</p>

<p>The smaller the quiche, the simpler the topics. But as I write about more complicated topics, the size of the quiche grows.</p>

<p>At some point, I have to <strong>draw a line</strong> at how deep I want to go into the topic, because the quiche will get too big for the dish (and making the filling in the middle will take ages).</p>

<p>Basically: the more advanced topics I write about, the more explanations (and writing) is needed. And the more time it takes.</p>

<p><strong>Takeaway:</strong> It’s difficult to know where to stop when you’re writing a technical book. You need to somehow find the stop line. And stop there.</p>

<h2 id="every-day-im-learning">Every day I’m learning</h2>

<p>The most enjoyable part of writing a book has been <em>learning every day</em>.</p>

<p>Although I’ve worked with <a href="http://camel.apache.org/">Apache Camel</a> for over 4 years, there’s still a ton I don’t know. (There’s also a ton I don’t know about Java, either. I work in a relatively small area of the language.)</p>

<figure>
  <img src="https://monodot.co.uk/assets/img/jon-snow.gif" alt="You know nothing, Jon Snow (from Game of Thrones)" />
  
    <figcaption><i>Whimsical Game of Thrones reference
</i></figcaption>
  
</figure>

<p>It’s frustrating to realise what I don’t know, but it’s also quite energising. <strong>Learning is what drives me forward</strong>.</p>

<p>Writing a book helps me to visibly see the limit of my knowledge. I recognise what I can already explain easily, and what I need to research further before writing.</p>

<p>If I don’t know something, I search for it, and I go and learn.</p>

<p><strong>Takeaway:</strong> Nobody knows it all.</p>

<h2 id="break-it-down-into-chunks">Break it down into chunks</h2>

<p>If I don’t have a concrete idea of the task I’m meant to be working on, I can easily get caught in <em>minutiae</em> and lose sight of the bigger picture.</p>

<p>This happened for a while before I properly started writing. I didn’t really know what I should be working on next. Now I have a Trello board for the book:</p>

<figure>
  <img src="https://monodot.co.uk/assets/img/camelsbs-trello.png" alt="My Camel Step-by-Step board on Trello" />
  
    <figcaption><i>My Camel Step-by-Step board on Trello
</i></figcaption>
  
</figure>

<p>My Trello board helps to keep me on track. I create cards for book chapters and other tasks. When I complete a task, I mark it as completed, by archiving it.</p>

<p>I also use Trello as a bucket to store any other ideas I have. Some of these ideas will make it through into the finished book; I’ll try and be ruthless and cut the rest.</p>

<p><strong>Takeaway:</strong> Break a big project into small chunks, and track it.</p>

<h2 id="writers-block-its-only-a-draft">Writers’ block (it’s only a draft)</h2>

<blockquote>
  <p>When faced with writer’s block, lower your standards and keep going</p>
</blockquote>

<p>– William Stafford</p>

<p>Sometimes I write the same sentence three or four times, deleting it each time. Then I read it back and I sigh. It looks terrible.</p>

<p>I want every first draft sentence to be perfect and complete. But this causes me to get stuck. And then I wonder whether I’ll ever manage to write the sentence I want.</p>

<p>My solution in this situation is to follow the quote above: lower my standards and keep going. I grit my teeth, and I write the sentence anyway. I can always improve it later at the editing stage.</p>

<p><strong>Takeaway:</strong> Just write. It can all be edited later.</p>

<h2 id="i-sweat-the-small-stuff-window-dressing-is-real">I sweat the small stuff (window-dressing is real)</h2>

<p>Even before I started writing, I had already decided that I didn’t want to use a word processor to write the book. I wanted the flexibility of writing it in plain-text, using a toolchain to typeset the book for me.</p>

<p>I might have finished the book earlier if I’d have used Google Docs or LibreOffice or Microsoft Word to write. But I would have been frustrated at the limitations of a WYSIWYG editor, and all that mouse-clicking. Thankfully at least losing entire documents in MS Word is a thing of the past these days.</p>

<figure>
  <img src="https://monodot.co.uk/assets/img/msword-error.png" alt="Writing in Microsoft Word" />
  
    <figcaption><i>Writing in Microsoft Word
</i></figcaption>
  
</figure>

<p>Owning the entire process from end-to-end has been one of the big positives for me. I’ve enjoyed a lot of the small stuff, even down to things like choosing typefaces and formatting.</p>

<p>I decided to write using <a href="https://asciidoctor.org/">Asciidoctor</a>, and I’ve learned a ton about it. I’m definitely going to use it for my next project! Recently, I’ve also discovered the <a href="https://github.com/asciidoctor/asciidoctor-maven-plugin">Asciidoctor Maven Plugin</a> for publishing, and from that I’ve learned a ton about Maven, too.</p>

<h2 id="creating-opens-possibilities">Creating opens possibilities</h2>

<p>As I’ve learned new things while writing the book, I’ve also encountered new problems: things which I wish were solved.</p>

<p>I’ve discovered new frustrations, and that means potential problems to solve; things like improving the workflow for technical writers.</p>

<p>This gives me ideas for future side projects and little things to work on, that I wouldn’t have if I hadn’t started writing.</p>

<p><strong>Takeaway:</strong> Start creating something (anything!) and you might find new problems to solve.</p>

<h2 id="write-in-the-mornings-polish-in-the-evenings">Write in the mornings, polish in the evenings</h2>

<p>I always thought that I was “a morning person”. Writing a book has really confirmed that hypothesis.</p>

<p>I’m at my creative best in the mornings.</p>

<p>I’ve tried many times to write in the evenings, after getting home from work. Although I don’t feel tired, I just don’t get the same spark as easily as I get in the mornings. Mostly I just stare at the laptop screen, or get sidetracked by blogs and Twitter.</p>

<p>If I wake up early in the morning, <strong>as long as I know what my next task is</strong>, I can crank out 500 words before work, without a problem.</p>

<p>The key is to always know exactly what I’m working on when I wake up.</p>

<p><strong>Takeaway:</strong> Join the “get up at 6am” club. (Not quite ready for the 5am club yet)</p>

<h2 id="tracking-keeps-me-on-track">Tracking keeps me on… track</h2>

<p><a href="https://www.stridesapp.com/">Strides</a>, an iOS app I downloaded years ago for goal and habit-tracking, and which I’ve picked up again and found useful for tracking exactly which days I’ve been able to write.</p>

<p>I also track my progress via the total word count of the book. I use a simple Google Sheet and a chart to show progress as I move towards the finish line.</p>

<p>Here’s my not-quite-consistent approach to writing:</p>

<figure>
  <img src="https://monodot.co.uk/assets/img/word-count.png" alt="Word Count tracker" />
  
    <figcaption><i>Word Count tracker
</i></figcaption>
  
</figure>

<p><strong>Takeaway:</strong> Set deadlines and track things.</p>

<h2 id="life-gets-in-the-way">Life gets in the way</h2>

<p>Finally, life is just busy, especially as I am currently working away from home, in the beautiful city of Edinburgh. This means I travel Mondays and Fridays, so they’re less than ideal days to work on the book.</p>

<figure>
  <img src="https://monodot.co.uk/assets/img/busy.jpg" alt="Busy busy busy" />
  
    <figcaption><i>Busy busy busy
</i></figcaption>
  
</figure>

<p>Expecting to be able to spend all your free time working on your side project? Then you’ll have less time to see your friends and family.</p>

<p>Those “how I crushed my dreams in 7 days” type posts on Medium can leave you with an <strong>unrealistic expectation</strong> of what’s actually possible in your own free time.</p>

<p>Life and work gets in the way, so I miss a few days every now and then, for seeing friends, meeting people, nights out with colleagues.</p>

<p><strong>Takeaway:</strong> No project is worth sacrificing all social contact for.</p>

<hr />

<p>To find out more about the book: <a href="https://cleverbuilder.com/camelstepbystep">https://cleverbuilder.com/camelstepbystep</a></p>

<p><em>Cover image by Joanna Kosinska on Unsplash</em></p>]]></content><author><name>Tom Donohue</name></author><summary type="html"><![CDATA[Recording what I'm learning from writing my first book, Camel Step-by-Step]]></summary></entry><entry><title type="html">Quarterly Review: 2018 Q2</title><link href="https://monodot.co.uk/review-2018-q2/" rel="alternate" type="text/html" title="Quarterly Review: 2018 Q2" /><published>2018-07-01T10:00:00+00:00</published><updated>2018-07-01T10:00:00+00:00</updated><id>https://monodot.co.uk/review-2018-q2</id><content type="html" xml:base="https://monodot.co.uk/review-2018-q2/"><![CDATA[<p>Welcome to my second quarterly review. This is where I share what’s going on in my side projects - the things that are working, the things that aren’t, and how I’m feeling about it.</p>

<p>My current side projects are:</p>

<ul>
  <li>
    <p><a href="https://cleverbuilder.com">Clever Builder</a> - articles on programming, specifically around Java</p>
  </li>
  <li>
    <p><a href="http://flat.haus">Flat Haus</a> - a small home decor website and <a href="https://instagram.com/flat.haus">Instagram account</a> - I’m not doing much with this site at the moment, as I don’t have the time.</p>
  </li>
</ul>

<h2 id="clever-builder">Clever Builder</h2>

<p>This quarter, I reached 17,200 users on Clever Builder! I’m happy with that.</p>

<p>This is means that the number of users has risen by 29% from the previous quarter.</p>

<p><img src="https://monodot.co.uk/assets/img/quarterly-2018q2-audience.png" alt="Clever Builder 2018 Q2 stats" /></p>

<p>My traffic still comes almost exclusively from organic search - but as I’m growing my email list, email referrals are now starting to show an appearance (although still only 0.3%):</p>

<p><img src="https://monodot.co.uk/assets/img/quarterly-2018q2-channels.png" alt="Clever Builder 2018 Q2 referrals" /></p>

<p>Speaking of email, my email list (hosted with <a href="https://www.drip.com/">Drip</a>) has grown to 342 subscribers:</p>

<p><img src="https://monodot.co.uk/assets/img/quarterly-2018q2-subscribers.png" alt="Clever Builder 2018 Q2 subscribers" /></p>

<p>Drip tells me that I have a subscription rate (conversion of visitors to subscribers) that hovers between 1.5-2%.</p>

<p>This quarter, I wrote quite a few articles!</p>

<ul>
  <li>
    <p><a href="https://cleverbuilder.com/articles/camel-spring-java-config/">How to use Camel with Spring Java configuration</a></p>
  </li>
  <li>
    <p><a href="https://cleverbuilder.com/articles/camel-bean-validation/">Bean Validation with Apache Camel</a></p>
  </li>
</ul>

<p>Plus I started a new section on the site called “notes”. This is for shorter how-to articles, that I write when I’ve figured out how to do something, or solve a problem. I write them in case other people find the solution useful. Here are a couple of notes posts:</p>

<ul>
  <li>
    <p><a href="https://cleverbuilder.com/notes/infinispan-query-dsl/">Infinispan Query DSL quick example</a></p>
  </li>
  <li>
    <p><a href="https://cleverbuilder.com/notes/camel-shut-down-after-messages/">Shutting down Camel after X messages</a></p>
  </li>
  <li>
    <p><a href="https://cleverbuilder.com/notes/dozer-camel-languages/">Using languages with Dozer in Camel</a></p>
  </li>
</ul>

<p>I also started experimenting with YouTube. A lot of people learn through videos, so I published a couple of short, snappy screencasts. These are easy to make and quite a lot of fun!</p>

<ul>
  <li>
    <p><a href="https://cleverbuilder.com/videos/camel-rest-service/">Creating a REST service using the REST DSL</a> (<a href="https://www.youtube.com/watch?v=aMCIw88AZeA">YouTube</a>)</p>
  </li>
  <li>
    <p><a href="https://cleverbuilder.com/videos/camel-mockendpoints-annotation/">Use the @MockEndpoints annotation in Camel</a> (<a href="https://www.youtube.com/watch?v=NfQL43mGT6s">YouTube</a>)</p>
  </li>
</ul>

<p>But the biggest news is that I <strong>started writing a book.</strong></p>

<p>At the start of the quarter, I spruced up my existing <em>Introduction to Apache Camel</em> guide, and put up a landing page for a forthcoming <a href="https://cleverbuilder.com/camelstepbystep">book on Apache Camel for beginners</a>.</p>

<p><img src="https://monodot.co.uk/assets/img/camelsbs-landing.png" alt="Camel Step-by-Step initial landing page" /></p>

<p>I’ve opened up pre-orders for the book, and I updated my welcome email campaign in Drip, to add a couple of links to the new book. I’ve also sent out a free chapter to existing subscribers.</p>

<p>To my absolute joy, I’ve had <strong>9 sales of the book this quarter</strong>. That may not sound like a lot, but for someone who’s never launched a product before, it’s been fantastic!</p>

<p><img src="https://monodot.co.uk/assets/img/quarterly-2018q2-gumroad.png" alt="Gumroad state 2018 Q2" /></p>

<p>So let’s have a look at the numbers for Q2:</p>

<ul>
  <li>
    <p>Google Analytics users: <strong>17,200</strong></p>
  </li>
  <li>
    <p>Subscription rate: <strong>1.9%</strong></p>
  </li>
  <li>
    <p>Email subscribers: <strong>342</strong></p>
  </li>
  <li>
    <p>Sales: <strong>9</strong> ✨✨✨</p>
  </li>
  <li>
    <p>Conversion rate (a crude measure, calculated using <em>sales ÷ email subscribers</em>): <strong>2%</strong></p>
  </li>
  <li>
    <p>Revenue: <strong>$171</strong></p>
  </li>
</ul>

<h2 id="analysis-and-thoughts">Analysis and thoughts</h2>

<p><strong>On writing</strong></p>

<p>Writing a book is really hard! It’s a huge project, and it’s kind of difficult to know where to start with a table of contents.</p>

<p>I threw up an outline table of contents on the <a href="https://cleverbuilder.com/camelstepbystep">landing page</a>, based on what I think newbie Camel developers want to learn.</p>

<p>Setting aside time to write the book is also really hard. I’m a bit of a reluctant writer, and I find it difficult to get into the “zone” of writing. Although once I’m in the zone, it’s easier to bash out a chapter.</p>

<p>I think creating a <a href="http://nathanbarry.com/commitment-changed-career/">commitment to write a set number of words a day, like Nathan Barry</a>, might be something worth doing.</p>

<p>Technical writing can also be difficult, because you’ve got to set up code samples first (and make sure they work!) before incorporating them into the book manuscript. And then you’ve got to write the explanatory text - explaining technical concepts takes quite a bit of thought!</p>

<p>I’m using Asciidoctor for my publishing workflow and it’s going great. I’m hoping to write an article on my process at some point.</p>

<p><strong>On selling</strong></p>

<p>9 sales may not sound like a lot, but for someone who’s never launched a product before, it’s been fantastic.</p>

<p>I don’t find it easy to write sales copy, and I’ve not pushed the book very much. My email subscribers have received a little encouragement to pre-order with an email or two, but that’s about it.</p>

<p>I plan to finish the book and then have a slightly bigger launch.</p>

<p>But I’m still a bit nervous about releasing a product into the wild - will people like it? This is something I’m really not sure of.</p>

<h2 id="reading-list">Reading list</h2>

<p>Things I read and listened to this quarter included:</p>

<ul>
  <li>
    <p><a href="https://convertkit.com/reach/reach-episode-10-nathan-barry-convertkit-show-consistently/">ConvertKit ‘Reach’ podcast: “Show up consistently” with Nathan Barry</a></p>
  </li>
  <li>
    <p><a href="https://www.reddit.com/r/Blogging/comments/8qg1vh/15_actionable_steps_for_writing_an_amazing_about/">Reddit: 15 Actionable Steps For Writing an Amazing About Me Page</a></p>
  </li>
</ul>

<h2 id="goals">Goals</h2>

<p>I’ve created a growth plan for <a href="https://cleverbuilder.com">Clever Builder</a> for the next year. My plans are to significantly grow my audience through writing more content about things other than Apache Camel.</p>

<p>I think my plans might be a tad ambitious 🤔  I’m aiming for an aggressive 20% month-on-month growth in pageviews:</p>

<p><img src="https://monodot.co.uk/assets/img/quarterly-2018q2-plan.png" alt="Site growth plan" /></p>

<p>These are just some initial figures, to help me focus my efforts.</p>

<p>At the moment I feel like I’m spinning the wheels trying lots of different things (tactics), but without a clear direction (strategy).</p>

<p>I also feel that I don’t have enough data to know what’s popular and what’s not.</p>

<p>Only time will tell whether these goals are achievable!</p>

<hr />

<p>Thanks for reading my quarterly review! I hope you found it interesting. If you have any comments, or if you’d like to know more, let me know in the comments below.</p>]]></content><author><name>Tom Donohue</name></author><summary type="html"><![CDATA[My second ever quarterly review, including my first ever book sales]]></summary></entry><entry><title type="html">First sale!</title><link href="https://monodot.co.uk/first-sale/" rel="alternate" type="text/html" title="First sale!" /><published>2018-04-16T10:00:00+00:00</published><updated>2018-04-16T10:00:00+00:00</updated><id>https://monodot.co.uk/first-sale</id><content type="html" xml:base="https://monodot.co.uk/first-sale/"><![CDATA[<p>Huge week to share with you!</p>

<p>This week I presold my first three copies of <a href="https://cleverbuilder.com/camelstepbystep">Camel Step by Step</a>, my beginners guide to Apache Camel ebook.</p>

<p>I made my first sale last Monday, and then made <strong>two more, later in the same week!</strong></p>

<p>I was gobsmacked.</p>

<p>This is the first time I’ve offered up a product for sale online, and I’m very excited to have made sales. This happened without any spammy marketing campaigns, “outreach” or even any backlink building.</p>

<p>My sole strategy is writing decent content, hoping to get indexed by Google and helping people out.</p>

<p>I’m actually still writing the book, but last week I made it available as a “soft pre-launch”. This is where I’m taking pre-orders for the book at a discounted price.</p>

<p>This has two main benefits:</p>

<ul>
  <li>
    <p>For the reader, they get a prelaunch discount on the final book, which will be priced at $29 or higher. They also get to influence the content of the book: I’m taking suggestions from the community on what they’d like to see in the final content.</p>
  </li>
  <li>
    <p>For me, it allows me to gauge interest level in the book and see whether it’s a product worth creating. I’ve read a lot of blogs which recommend doing this, instead of spending months locked away creating a product, only to quickly discover on launching that nobody wanted it in the first place.</p>
  </li>
</ul>

<p>To “launch”, I created a simple landing page and extended my current email campaign I send to new subscribers, adding a new email introducing the product.</p>

<p>I haven’t emailed my existing subscribers (of which there are just under 180), probably because I’m a bit afraid of asking for a sale without providing more value to them.</p>

<p>That’s a fear that I should get over. One of a few fears.</p>

<h1 id="the-fear">The fear</h1>

<p>I get a lot of fears about releasing a product.</p>

<p>It’s difficult to release a product out there to the world, whether it’s a blog post or a book. I have a few “classic” fears that I have my head on rotation:</p>

<ul>
  <li>
    <p>The product isn’t good enough</p>
  </li>
  <li>
    <p>My writing is terrible</p>
  </li>
  <li>
    <p>I’ve picked a niche that is far too small</p>
  </li>
  <li>
    <p>I’m going to get negative reviews</p>
  </li>
  <li>
    <p>The product doesn’t actually solve a problem for people</p>
  </li>
  <li>
    <p>I feel guilty charging money for something I’ve created</p>
  </li>
</ul>

<p>There’s also a big dose of <a href="http://candleinsunshine.com/musings/smart-kids-eventually-grow-up/">impostor syndrome that I want to get over</a>.</p>

<p>All of these fears are things that I hope to overcome. I want to do that by simply getting my work out there, and into the hands of people who want it.</p>

<p>And that means shipping.</p>

<h2 id="the-first-sale">The first sale</h2>

<p>So, fears aside, how did the first sale happen?</p>

<p>It didn’t start with outreach. It didn’t start with guest blogging, or Google Ads, or posting on Reddit.</p>

<p>It started with helping someone, 1-on-1.</p>

<p>On <a href="https://cleverbuilder.com">Clever Builder</a>, I encourage comments and messages from blog readers. Readers can interact with me in three ways:</p>

<ol>
  <li>
    <p>I have comments forms on every article (powered by Disqus - soon to change to the <a href="https://github.com/posativ/isso">Isso commenting engine</a>).</p>
  </li>
  <li>
    <p>Mailing list subscribers can hit reply to any email, and email me directly with questions or feedback.</p>
  </li>
  <li>
    <p>There is also a <a href="https://cleverbuilder.com/contact">traditional contact form</a> where people can send messages and ask questions</p>
  </li>
</ol>

<p>This is because I like to hear from readers. I want to know if the stuff I’m producing is actually useful to someone.</p>

<p>My strategy at the moment – whether right or wrong – is just throwing content out there, on my topic, into <em>the cold, unforgiving void of the internet</em>.</p>

<p><big><strong>How do you stay motivated if you don’t know if your content is helping anyone?</strong></big></p>

<p>Over the past couple of weeks, I’ve been exchanging emails with a blog reader from the USA. He originally got in touch via the contact form to ask a couple of questions about Camel.</p>

<p>I took time to respond to his question, responded freely to his follow-up questions, and eventually left him with a working example that demonstrated how he could achieve his requirement.</p>

<p>In response, the reader enquired about pre-ordering the book! He said he received quite a lot of value from me and was happy to support the book in return. I was surprised when my first notification from Gumroad came through to say that I’d made a sale.</p>

<p><strong>Result! Sale number one!</strong></p>

<p>The reader has also since emailed me to say that he’s looking forward to receiving the book when it’s released.</p>

<h2 id="customers-2-and-3">Customers 2 and 3</h2>

<p>My second and third sales also took me by surprise.</p>

<p>I was at work a couple of days later, still thinking about my first sale, and thinking about writing this very blog post to share my news.</p>

<p>I went to my Gumroad dashboard to take a screengrab. And I was very puzzled when I saw that my dashboard was showing three sales.</p>

<p><img src="https://monodot.co.uk/assets/img/gumroad-3sales.png" alt="3 sales in Gumroad!!" /></p>

<p>I put this down to one of my previous test purchases showing up erroneously. But, on further glance, it definitely looked like I’d made two new sales somehow.</p>

<p>When I looked at the sales data, it seemed that a further sale had come from someone else who I’d been helping with her Camel questions over email.</p>

<p>So, again, helping people and answering questions led to a sale.</p>

<p>My next sale came from someone who I had not interacted with directly, but who was on my mailing list.</p>

<p>These two sales came in one day! I took the train home from work with a spring in my step.</p>

<p>So in all three cases, sales came from people who I had either helped out with their individual questions, or who I’d built up a relationship with via my freebies and my mailing list.</p>

<h1 id="the-feeling-of-the-first-sale">The feeling of the first sale</h1>

<p>This is the first product that I’ve created. It felt amazing to know that people actually want to buy something I created.</p>

<p>I previously worried that I was serving a tiny, difficult niche (enterprise integration developers!), and that it would be impossible to make a sale.</p>

<p>But my sales this week show that’s maybe not entirely true.</p>

<p>If you can provide real value to someone, they will buy from you.</p>

<p>I’m buoyed by these sales and can’t wait to finish the book. The great bonus is that I now have a small amount of data that I can start using to improve what I offer for my blog readers.</p>

<p>Onward!</p>

<p><em>This post is part of my ride-along series, where I’m recording my progress in building and launching a product in 2018.</em></p>]]></content><author><name>Tom Donohue</name></author><category term="product2018" /><summary type="html"><![CDATA[My first ever digital product sale.]]></summary></entry><entry><title type="html">Pre-orders now available for my book</title><link href="https://monodot.co.uk/power-weekend/" rel="alternate" type="text/html" title="Pre-orders now available for my book" /><published>2018-04-02T10:00:00+00:00</published><updated>2018-04-02T10:00:00+00:00</updated><id>https://monodot.co.uk/power-weekend</id><content type="html" xml:base="https://monodot.co.uk/power-weekend/"><![CDATA[<p>It’s Easter weekend. That means 4 days off work. Perfect time to get stuff done.</p>

<p>This weekend I didn’t have much in the diary, so as well as getting in some much-needed R&amp;R (sofa time, watching <em>Boss Baby</em> and <em>Terminator</em>….), I also cleared these off my to-do list this weekend:</p>

<ul>
  <li>
    <p>Created and published a <a href="https://cleverbuilder.com/camelstepbystep">landing page for my forthcoming book Camel Step-by-Step</a>. I’ve decided to go with a soft launch for the book, rather than a big bang.</p>
  </li>
  <li>
    <p>Created <a href="https://gumroad.com/l/camelstepbystep">a product in Gumroad</a> for the book - you can buy it now!</p>
  </li>
  <li>
    <p>Updated my <a href="https://www.drip.com">Drip</a> post-subscribe campaign, by adding two new emails introducing the book</p>
  </li>
  <li>
    <p>Updated and expanded my previous “Introduction to Apache Camel” freebie into a full PDF sample of the book, published using Asciidoctor</p>
  </li>
  <li>
    <p>Pushed an initial update to <a href="https://cleverbuilder.com/articles/camel-tutorial/">one of my most popular articles, the Apache Camel Tutorial</a> - with another update to follow</p>
  </li>
</ul>

<p>I have typed <strong>a lot</strong> this weekend.</p>

<p><em>This post is part of my ride-along series, where I’m recording my progress in building and launching a product in 2018.</em></p>]]></content><author><name>Tom Donohue</name></author><category term="product2018" /><summary type="html"><![CDATA[It's amazing what you can get done in a long weekend.]]></summary></entry></feed>