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.
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.
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.