---
title: "On Metadata and Help Content"
date: 2013-05-27
description: "$( document ).ready(function() { // Handler for .ready() called. $("
canonical_url: https://idratherbewriting.com/2013/05/27/on-metadata-and-help-content/
---
# On Metadata and Help Content
[![karen-mcgrane-keynote-drupal](https://s3.us-west-1.wasabisys.com/idbwmedia.com/images/karen-mcgrane-keynote-drupal.png)](http://karenmcgrane.com/2013/05/23/drupalcon-keynote-video-and-talk-notes/)

In her presentation, Karen emphasized the need to transform content management systems away from the "content goes here" type of blob to a CMS that separates content from format, one that allows users to embed metadata into their content and maintain the content in a clean, structured way so that it can be ported to another platform and re-used elsewhere.

Karen said that structured content helps future proof the content, so that when you need to get your content into audio interfaces, digital signs, billboards, internet refrigerators, touch screens, watches, Google Glass, smart TVs, or some other platform, you can get your content out. She writes:

> Because future-friendly content requires true separation of content from presentation. We have to support too many different outputs for content to assume that we can couple content with presentation. Do you have any idea what a huge shift this is in the way we think about content? For most of human history, it was impossible to produce a document without considering meaning and appearance together. All of our semantic cues as to priority, weight, relationships in content come through visual styling. But now we need new tools, new processes to achieve that.
> Personally, I talk all the time about the limitations of what I call blobs, of giving content creators a big bucket into which they can dump whatever they want, style their content with tools that work “just like Microsoft Word,” add tables and custom bullets and make the text purple Comic Sans and float it to the right. Blobs are limiting, because all of this formatting, all of this meaning doesn't translate when you try to take it to another platform.

She calls for "new tools, new processes" to embed "semantic cues" into CMS content. Although the reuse examples mostly point to getting the content onto different platforms, I think there's also a strong case for dynamic repurposing on the same web platform.

> Many times we build a table of contents for our content, following the same methodology as a printed book, and leave it at that, forcing every reader, for nearly every situation, to follow the same rigid organization through the content.

The web liberates us from the constraints of the physical world. Content doesn't have to be in one place at one time. The chair or bed you're probably sitting on can only exist in one place at one time, but your web content can exist in multiple places simultaneously.

Through metadata, you tag your content with terms from your taxonomy that describe the content's purpose. You might have half a dozen vocabularies, some describing the content by its subject, others by function/task, others by audience, by subject, by format, by framework, by API platform, by component, and so on. You can then manipulate the metadata into myriad organizations to suit different purposes. The rules of your CMS govern where the content appears. The metadata can be exposed as facets in search results to determine how results get progressively narrowed.

Further, you can build sophisticated filters that *combine* the metadata in various ways. Say you want to find all content that fits the ACME API (a tool) *and* is used for configuring widgets (a function) *and* which suits a developer audience (a persona). Voila, either through a selection of faceted filters or pre-built queries, you can return this information to the audience immediately and dynamically.

In my opinion, liberating content from a static, single position in a table of contents is probably the most relevant, immediate benefit of moving content to the web. But until we start enriching our content with metadata and semantic cues, we can't push or pull it in interesting ways.