Refining my writing process

I’m in the process of writing an article about the recent rebuild of my website, but there’s one thing that I fancy sharing ahead of the ‘official’ announcement.

My site used to be built with a CMS called Perch, which was great when I was doing more client work, where Perch was my CMS of choice and I could try new features with myself as the guinea pig. Perch is great. But it being a database-driven CMS presented a bit of a hurdle when it came to writing and posting articles.

I’ve written about my writing app of choice, iA Writer; that’s where my writing workflow starts. There’s no extra thinking involved when putting some new ideas down – I just open a new document and start typing. And every article I work on is automatically saved in iCloud so I can pick up exactly where I left off, even from another device.

It was the stages after that where things got fiddly using a CMS: final edits, publishing, making updates, archiving files, etc.

My previous CMS-driven process

  1. Write the article in iA Writer
  2. When it was ready, log into my site’s CMS
  3. Copy and paste the contents of the article into a new blog article in the CMS
  4. Configure the meta-data
  5. Save it as a draft
  6. Preview the draft
  7. Make any edits
  8. Publish the article
  9. Archive the draft by renaming the iA Writer file and moving it to a central /articles/ folder in my iCloud Drive
  10. Add the meta-data to the file as front-matter (not that it’d be used anywhere, but it means that I know how I categorised the post, what unique page description I gave it, etc.)
  11. If any updates are required, edit the archived file and the version on the CMS

My new file-based process

My new site is a static build with Eleventy, which has removed duplication and simplified my process:

  1. Write the article in iA Writer
  2. When it’s ready, create a new branch for it in my site’s repository
  3. Copy and paste the contents of the article into a new blog article in the CMS
  4. Configure the meta-data in the file’s front-matter
  5. Preview the draft locally
  6. Make any edits
  7. Publish the article (along with any other site updates that have been made since the last release)
  8. Delete the draft from iA Writer
  9. If any updates are required, make them in the repo and publish when ready

A very developer-centric workflow, but it works well for me and means I’m not updating the same content in more than one place at any given time.

Posted in Workflows

Follow along

If you enjoyed this post and want to know when the next one is published, head to Twitter and hit ‘Follow’.


More posts

Here are a couple more posts for you to enjoy. If that's not enough, have a look at the full list.

  1. HTML is more complicated than you think

    HTML, like CSS, is easy to learn. Trouble is, if you want to write it well, it gets difficult very quickly.

  2. Using the HTML document outline

    What is a document outline? Sounds complicated, but it’s really not – it’s just headings! Find out more about them and why they’re a good idea.