Minimalist Documentation: How about a Haiku?

At Eucalyptus, we’re about to go through a documentation content audit. One of the goals of this audit is to see where we need to rewrite our content more concisely. When done well, concise content makes for easier understanding, and usually provides a way for cheaper and more precise translations.

But what constitutes brevity in content? Could we just use a haiku format? Before I dismiss that idea, I think I need to test it out:

My cloud computing
deployment is merciless.
So complex. So sad.

But FastStart can make
installation a snap. Though
not a ginger snap.

Okay, maybe not a haiku format.

Move along folks. Nothing to see here.

About scotmarvin

Scot is a content strategist for Oracle. He's a slacker and smartass involved in content design, content architecture, big data, cloud computing, and other buzzwords related to technical stuff. He loves his family, history books, jazz guitar, and the Minnesota Vikings. Scot is a proud father, so don't make the mistake of asking about his family unless you have four hours to listen to him ramble on about his kids.
This entry was posted in documentation, minimalism. Bookmark the permalink.

Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s