Skip to content

Tag gardening

Published:

4 min read

I recently came across Karl Voit’s blog post about the concept of tag gardening. He uses this process to trim down the various tags he uses and provides explanation on the decision he took during the cleanup.

His blog post served as a timely reminder of why I should clean up some of the tags from my blog. I wrote this post to appreciate Karl’s efforts and share my thoughts on the topic.

What is tag gardening?

According to Karl, tag gardening is a practice of cleaning up the chaos that can result from having too many tags on a blog, over a period of time.

Best practice: limitation

Karl describes one best practice, which is:

Limit the number of tags on a blog.

Recently, I refactored my blog to migrate from Next.js to Astro and I noticed that I had a lot of tags. I’ve never done a tag refactor before and I could see having excessive tags creates a clutter.

I consider tags an integral part of any blog. They easily allow us to navigate and explore a topic of interest deeply by finding related posts written on the same blog.

Limiting the number of tags on a blog is something I’ve started advocating for on my blog as well.

Technique to trim down tags

Before writing this post, my blog had 21 tags. To manage this tag cloud, I’ve done the following:

Delete singular tags

Cloud of tags before writing this post

The above image illustrates the tag cloud before performing the act of trimming them down. Tags such as #conference, #devrel, and #writing, each have one post and the situation hasn’t changed since I created them. Currently, I’m not planning to write anything that may fall under those tags so I decided to group them under an existing tag called #notes.

I use #notes as a general purpose tag where I can share thoughts without focusing on technical details, unlike other tags on my blog.

Notes tag highlighted in the tag cloud

Another example is about the posts I’ve written on specific tools I use. I started creating individual tags for each tool so it would be easier to find more posts about them on my blog. Having each tool as a separate tag made sense since I was writing multiple posts about each tool. Some of these tags are #vscode, #xcode, and #obsidian.

After a while, I created a #tools tag that included posts about other topics such as writing about my macbook setup or the default apps I use. Since this tag was used in a generic way, I found myself repeating topics. To categorize them clearly, now I’ve created a #macos individual tag and rest of the unrelated topics, I’ve moved them under #notes.

This time I had to divert from the practice a bit to create a new tag.

Tags cloud now

At the time of writing this post, my blog has 18 tags. Four tags deleted, and one new tag added.

Notes tag highlighted in the tag cloud

Best practice: use plural forms

Karl suggests using plural forms when creating tags:

…singular form contradicts the common convention of using the plural form of tags.

This practice doesn’t apply to specific tags like “vscode” or “xcode”. It only applies to the general terms such as:

I previously used #year-review as a tag for my yearly review posts. Following Karl’s advice, I changed it to #year-reviews since I have multiple posts under this category.

Summary

Over the years while maintaining this blog, I’ve thought a lot about using tags effectively. I never encountered a concrete example and practice as a tag gardening. Karl’s post inspired me to and helped me manage the emerging chaos of tags on my blog. I’ll continue to nurture this garden.

I'm a software developer and a technical writer. On this blog, I write about my learnings in software development and technical writing.

Currently, working as a documentation lead at Expo.