Technical Writers Blog Also

Peter Villani
Feb 5, 2019 · 2 min read
Image for post
Image for post

For some technical writers, writing a blog comes as a relief, a sudden respite from the exigencies of precision and concision. Like when a tour guide goes off alone onto the less-trodden paths of her homeland, plunging deeply into familiar digressions of ambiguity, subjectivity, and multiple levels of meaning. Technical writers can digress too. In a blog.

The success of a blog lies not in its content but in what it provokes, because while everything on the surface is content, nothing being said is on the surface.

Thus freed from helping others to understand precise technical terms or do something correctly, a blog attempts to help people think differently and to engage them to say not only Yes or No but Maybe. Writing a blog can move a reader from one vague point to another, because life is the stuff we place in suspension between two edges. Before falling …

The blog takes its time because it needs space.

A blog gives space for the technical writer to embellish and the reader to reflect. It’s an open flow, where the writer can guide the reader into the same space as herself, or can suggest to the reader to go somewhere else. It’s entirely up to each writer and reader to define.

The subtext in a blog can be more present than the text, the surface only an excuse to engage. The words of a blog are sometimes opposed to their plain meaning. The writer can write with one intention, while the reader takes away something entirely different.

Developing an idea in a blog is far more important than completing it.

A blog is a collection of more than one idea in parallel, where each idea is a thread that needs space to move within, a space that resides not only in the text but in the reader’s will to invent and behold.

A blog is not technical writing. Which is good for both blogging and technical writing. 😌

Peter Villani

Written by

Started writing this blog to reflect on my technical writing craft. I have another blog where I reflect on everything else. www.codeharmonics.com.

Writer’s Blogk

Notes from the technical writing underground. Journaling by a technical writer.

Peter Villani

Written by

Started writing this blog to reflect on my technical writing craft. I have another blog where I reflect on everything else. www.codeharmonics.com.

Writer’s Blogk

Notes from the technical writing underground. Journaling by a technical writer.

Medium is an open platform where 170 million readers come to find insightful and dynamic thinking. Here, expert and undiscovered voices alike dive into the heart of any topic and bring new ideas to the surface. Learn more

Follow the writers, publications, and topics that matter to you, and you’ll see them on your homepage and in your inbox. Explore

If you have a story to tell, knowledge to share, or a perspective to offer — welcome home. It’s easy and free to post your thinking on any topic. Write on Medium

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store