{"id":2750,"date":"2020-02-18T04:23:30","date_gmt":"2020-02-18T04:23:30","guid":{"rendered":"https:\/\/blog.hassler.ec\/wp\/?p=2750"},"modified":"2020-02-15T00:28:41","modified_gmt":"2020-02-15T00:28:41","slug":"metaphor-in-technical-writing","status":"publish","type":"post","link":"https:\/\/blog.hassler.ec\/wp\/2020\/02\/18\/metaphor-in-technical-writing\/","title":{"rendered":"Metaphor in Technical Writing"},"content":{"rendered":"
\n
\n
\n
<\/div>\n<\/div>\n<\/div>\n<\/div>\n
\n
\n
\n
\n
\n
<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/figure>\n<\/div>\n
\n
\n

This is how technical documentation works \u2014 a technical writer gets a new task, does research and consults subject-matter experts to get max knowledge. Along the way the\u00a0tech writer<\/a>\u00a0is drawing up a plan, a scheme to pass the knowledge to the readers. This is never as simple as retelling, it takes a lot of thought and effort to write comprehensive technical texts.<\/p>\n

Skilled techcomm specialists have a hunch when it comes to choosing techniques to use for content building \u2014 they see a text, read it through and start re-modeling it in their mind right away.<\/p>\n

There are many things you can do with a text to make it perfect for your readers. Things like lists, tables, schemes, screenshots, gifs, videos, even paragraph division work like a charm when done right.<\/p>\n

Today, however, we would like to talk about something less technical \u2014 a metaphor. Is there a place for metaphors in\u00a0technical writing<\/a>? Yes, and if you are still ignoring them, we would like to change your mind.<\/p>\n

\n
\n
\n
\n
<\/div>\n

<\/div>\n<\/div>\n<\/div>\n<\/figure>\n

All the World\u2019s a Stage<\/h1>\n

What is a metaphor? Let\u2019s look it up. Wiki puts it like this:<\/p>\n

A metaphor is a figure of speech that, for rhetorical effect, directly refers to one thing by mentioning another.<\/em><\/p>\n

It is also mentioned there that a metaphor\u00a0may provide (obscure) clarity<\/em>. Now, how is this supposed to work? As a literary device, metaphors definitely embellish a text. Also, certain metaphors can make things less clear especially on the first read \u2014 they can be complex and misleading for an unprepared audience. They can be also called\u00a0poetic metaphors.<\/em>\u00a0These are not the metaphors we are going to talk about in this blog post. You can find them in literature and poetry. Here\u2019s a famous quote by Orwell:\u00a0\u201cAdvertising is the rattling of a stick inside a swill bucket\u201d<\/em>. That certainly makes a mind wander.<\/p>\n

Technical writers are only interested in the ones that provide clarity, they are often called\u00a0scientific analogies<\/em>. Metaphors are making things clearer by giving readers a vivid picture of a thing or a process that facilitates user comprehension. And this can work even better than simply describing stuff in strictly technical terms.<\/p>\n

\n
\n
\n
\n
<\/div>\n

<\/div>\n<\/div>\n<\/div>\n<\/figure>\n

Here\u2019s an example:\u00a0\u201c\u2026cell membranes as mosaic structure of oriented globular proteins and lipids.\u201d\u00a0<\/em>After reading this, we can see a simple picture of a complex phenomenon.<\/p>\n

Or, software development is often described as\u00a0\u201cbuilding a house\u201d<\/em>. We all understand that there can be no house without a plan. This plan is an equivalent of developing software architecture which is crucial.<\/p>\n

But this is not the only purpose of using metaphors. Literary devices are the means to humanize technical documents, and metaphors are no exception.<\/p>\n

You see, reading technical documentation is not a fun ride for the majority of people. It can seem overwhelming or simply boring due to its technical nature. Looking for ways to make it sound more human and maintain (or even improve) its clarity is what has brought us to metaphors.<\/p>\n

Another advantage of using metaphors is to make the process of creating content more compelling for technical writers as they may feel very restricted by all the standards.<\/p>\n

Metaphors are not the only literary devices that can prove extremely useful for successful technical communication. If you are interested in this topic and want to humanize your technical documentation, refer to this\u00a0blog post<\/a>.<\/p>\n

\n
\n
\n
\n
<\/div>\n

<\/div>\n<\/div>\n<\/div>\n<\/figure>\n

Conclusion<\/h1>\n

Surely, technical texts will never become literature. It defeats the purpose. At the same time, humanization of technical documents can do a lot of good to the whole techcomm society.<\/p>\n

Technical writers have a wide range of tools at hand to improve\u00a0user manuals<\/a>, and overlooking things like metaphors would be a mistake.<\/p>\n

Good luck with your technical writing!
\nClickHelp Team<\/a>
\nAuthor, host and deliver documentation across platforms and devices<\/p>\n<\/div>\n<\/div>\n

\n

\n

\n

<\/p>\n

\n

Source: https:\/\/medium.com\/level-up-web\/metaphor-in-technical-writing-82ba88d951f5<\/a><\/strong><\/p>\n

Written by<\/strong><\/p>\n

\"ClickHelp\"<\/a>ClickHelp<\/a><\/div>\n
\n
\n

ClickHelp – Professional Online Technical Writing Tool. Check it out: https:\/\/clickhelp.com\/online-documentation-tool\/<\/a><\/h4>\n<\/div>\n<\/div>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n","protected":false},"excerpt":{"rendered":"

This is how technical documentation works \u2014 a technical writer gets a new task, does research and consults subject-matter experts […]<\/p>\n","protected":false},"author":2,"featured_media":2753,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[12,128,47,21,40],"tags":[],"class_list":["post-2750","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-bloghassler-ec","category-clickhelp","category-medium","category-productividad","category-technical-writer"],"_links":{"self":[{"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/posts\/2750","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/comments?post=2750"}],"version-history":[{"count":1,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/posts\/2750\/revisions"}],"predecessor-version":[{"id":2754,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/posts\/2750\/revisions\/2754"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/media\/2753"}],"wp:attachment":[{"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/media?parent=2750"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/categories?post=2750"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.hassler.ec\/wp\/wp-json\/wp\/v2\/tags?post=2750"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}