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.

Advertisements

About scotmarvin

Scot is a writer for Oracle. He's a slacker and smartass involved in content strategy, 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:

WordPress.com Logo

You are commenting using your WordPress.com 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