This post originated from an RSS feed registered with Agile Buzz by Martin Fowler. Original Post: Bliki: EvolvingPublication Feed Title: Martin Fowler's Bliki Feed URL: http://martinfowler.com/feed.atom Feed Description: A cross between a blog and wiki of my partly-formed ideas on software development Latest Agile Buzz Posts Latest Agile Buzz Posts by Martin Fowler Latest Posts From Martin Fowler's Bliki

When I was starting out on my writing career, I began with writing articles for technical magazines. Now, when I write article length pieces, they are all written for the web. Paper magazines still exist, but they are a shrinking minority, probably doomed to extinction. Yet despite the withering of paper magazines, many of the assumptions of paper magazines still exact a hold on writers and publishers. This has particularly risen up in some recent conversations with people working on articles I want to publish on my site.

Most web sites still follow the model of the Paper Age. These sites consist of articles that are grouped primarily due to when they were published. Such articles are usually written in one episode and published as a whole. Occasionally longer articles are split into parts, so they can be published in stages over time (if so they also may be written in parts).

Yet these are constraints of a paper medium, where updating something already published is mostly impossible. [1] There's no reason to have an article split over distinct parts on the web, instead you can publish the first part and revise it by adding material later on. You can also substantially revise an existing article by changing the sections you've already published.

I do this whenever I feel the need on my site. Most of the longer-form articles that I've published on my site in the last couple of years were published in installments. For example, the popular article on Microservices was originally published over nine installments in March 2014. Yet it was written and conceived as a single article, and since that final installment, it's existed on the web as a single article.

Our first rationale for publishing in installments is the notion that people tend to prefer reading shorter snippets these days, so by releasing a 6000 word article in nine parts, we could keep each new slug to a size that people would prefer to read. A second reason is that multiple publications allows for more opportunities to grab people's attention, so makes it more likely that an article will find interested readers.

When I publish in installments, I add an item to my news feed and tweet for each installment. Since I'm describing an update, I link with a fragment URL to take readers to the new section (in future I may link to a temporary explanatory box to highlight what's in the new installment).

But whatever the way the article is released to the world, it is still a single conceptual item, so its best permanent form is a single article. Many people have read the microservices article since that March, and I suspect hardly any of them knew or cared that it was originally published in installments.

In that case we wrote the entire article before we started the installment publishing, but there's no reason against writing it in stages too. For my collection pipelines article, I wrote and published the original article over five installments in July 2014. As I was writing it, I was conscious that there were additional sections I could add. I decided to wait to see how the article was received before I put the effort in to write those sections. Since it was pretty popular, I made a number of revisions, for each one I announced it with a tweet and an item on my feed.

Letting an article evolve like this is the kind of thing that's difficult in a print medium, but exactly the right thing to do on the web. A reader doesn't care that I revised the article to improve it, she just wants to read the best explanation of the topic at hand.

I do like to provide some traces of such revisions. At the end of each article, I include a revision history which briefly summarizes the changes. For a couple of revisions, such as the 2006 revision of my article on Continuous Integration, I made the original article available on a different URL with a link from the revised article. I don't think the original article is useful to most readers, only really to those tracing the intellectual history of the idea, so shifting the original to a new URL makes sense.

The role of the feed is important in this. The traditional blog reinforces the Paper Age model by encouraging people to match an article with its feed entry. For longer articles, I prefer to consider them as different things, the feed is a notice of a new article or revision, which links to the article concerned. That way I generate feed entries each installment where the feed summarizes what's been added.

The point of all this is that we should consider web articles as information resources, resources that can and should be extended and revised as our understanding increases and as time and energy allow. We shouldn't let the Print Age notions of how articles should be constructed dictate the patterns of the Internet Age.

Share:

if you found this article useful, please share it. I appreciate the feedback and encouragement