Posted in Technical Writing

Constructive Criticism

One often gets offended with the editor’s comments for improvisation. Either be an editor or a techcomm manager, the goal is to provide clean output that guarantees customer satisfaction.

Construction criticism is mostly considered as mere criticism that leaves the receiver getting offended easily.

It is advisable to learn from ones mistakes and improve their capabilities rather than turning bitter. Moreover it’s the responsibility of the editor to help improve the documentation. There is no way it can be sugarcoated. If the team works in unison, mindful of the constructive criticism and work towards progress, it will be a bliss, else a headache to the Techpub.

Kavitha Patchamalai

Posted in Technical Documentation

Technical documentation conversion projects, often a failure!

The writing style matters the most while converting a doc/pdf document to the Web. Mostly, such projects are published online with a publishing tool that converts the documents into HTML and CHM help files (exact copies). This is the easiest form of conversion but a total disaster in terms of language consistency, voice, style, and formats. The strength of online help lies in information mapping. It’s nothing but creating relevant topics/content that can be linked for easy navigation. This is one of the effective ways to control redundancy. Task-based documentation must be the primary goal while writing for the web. Writers often get carried away focusing on the new publishing tool leaving the content unchanged.

 It is highly recommended for a writer to rewrite the content in such a way that it adheres to the company standards and Web Content Accessibility Guidelines . During the conversion process, one may get tempted to overlook the standards required for the web as it needs time, patience.

Posted in Weekend

Couch Potato

Could hear the birds chirping,
And the dogs barking loudly,
As I tried to get out of my bed,
Sensed silence inside the house.
Its weekend! Can be lazy,
And enjoy the days in silence,
Thinking about useless things,
Roaming inside the house!
Sitting idle sounds peaceful,
With no car honking in my ears,
Need not pick and drop anyone,
So I closed my eyes to sleep.

Kavitha Patchamalai

Posted in Technical Writing

The Art of Technical Writing in a Nutshell!

Technical writing is a profession that requires strong communication skills to interact with the global audience and expertise to understand the functionalities of the software applications. It is not mandatory for the technical writer to have a deep knowledge of coding or technical language, but produce documents for the intended audience in a clear and concise manner. 

I recollect one of my HR friends saying, I can replace a technical writer within a week, unlike the other technical resources.” On the contrary, we only have a limited number of skilled technical writers who have the ability to create quality documents that are shipped with the product. Though editing is a part and parcel of the technical writing job, editors are hired for cleaning up the documents.     

Effective technical writing involves creating meaningful content, applying minimalism to some extent, that helps the readers to comprehend quickly. With the advanced authoring and publishing tools, it’s no big deal to create useful documentation devoid of redundant content as one can easily map relevant data. The technical writer must be a Grammar Nazi to succeed in the field of technical writing.

Kavitha Patchamalai

Posted in Deception, life

Bloody Mary

She keeps the buffoons next to her,
Plots against the straight minded,
Tries to put them on a strong leash,
If she fails, tricks them believe evil.

Acts to help them out of misery,
But keeps her aides around them,
Works hard behind them, slowly,
Pushing them to the verge of fall.

Selfish is she, cares to rise high,
Inhuman! not a human of course,
As you sow, so you reap is a saying,
That applies to the one that sinned.

Kavitha Patchamalai

Posted in To the beautiful you!

To the beautiful you!

To the beautiful you, rest in peace!
Life is too beautiful to end abruptly,
You should taste love, hatred and pain,
Which are nothing but a bundle of life.

Who is free from mystery?, you left,
So sudden, that is too unfair and cruel.
You must age gracefully, leave footprints,
For the world to remember you as you!

It’s sad that you are already gone,
You may rest now, with no pain,
As you may have felt “it’s painful”,
You became eternally beautiful!

Kavitha Patchamalai

Posted in Angel

An Angel

She, a pure soul worked with him,
He liked her for her humble nature,
Proposed and married her happily,
Seasons changed, so did he, cruelly.

The devil inside him provoked him,
Made him an obsessive man of rage,
Lost all his savings in intraday trading,
Gave her a tough time, drove her mad.

She stood strong, changed him with love,
Then came the blow so strong to digest,
That he is dying slowly, losing himself,
Yet, she hoped a miracle might happen!

Kavitha Patchamalai