Monday, February 26, 2007

Writing Etiquettes

In this world of fame, knowledge, money, action...when everyone is targeting for bulls eye..trying to achieve even higher, larger, harder goals....
goals which are better than the best!!!!!!

In such a militant environment ( really sorry! for some of my readers might find it disparaging)....ok I take my words back.....though my mother says ("Abrasive words once out, can never be taken back, without causing some harm somewhere)..

In such a competitive environment ( this sounds much better :-)), it becomes imperative to hone our skills..

Best would be to ameliorate our technical skills, bcz of many reasons :

Brings you in the category of highly salaried class..
Your social status is enhanced, be it in ur company, ur juniors, ur cousins..technical magazines!!

But then this isn't that easy, especially for average brains like me (sorry Blogger, couldn't refrain myself from self-review))), specially when u don't want to put in that much effort as well...

There's a good side to it as well: we have an enormous scope to brighten our non-technical panoroma.

Last week, I was asked by my manager to attend some role based mandatory training on "Technical writing".I really liked the trng, and somehow instead of being virtually present, I attended the trng with avid interest, pinging the trainer and other trainees after every 5-10 minutes..

The trainer came up with some wonderful points, which I am gonna list below..
And if there is something u could really catch up with, plz pass on some good wishes for my trainer, for I really scratched her brain that day!!

1. Should an engineer be bothered about writing a good document???????

well, surprisingly, YES..lets quote some examples..

Take some product based companies : Adobe, Motorola, ST, Microsoft, Oracle..

They keep on publishing their installation manuals, user-guides..and who prepares them, ofcourse not the managers!

some services based companies: Aricent( well this is mine, and trust me I have improved a lot when it comes to writing tech docs.), Infosys, Cognizant, Hughes Systique, Wipro, you have to write so many design docs, financial reports, survey analysis, requirement docs..

Some testing companies: AztecSoft (previously Disha technologies), TCS, Sun, Satyam, Accenture..there you have to write so many test plans, test scenarios, checklists, feature analysis..

2. Sequential V/s Flagship features:

Well, this is an open debate...No body in the trng fully agreed to the trnr's view point who believed in writing flagship featues first in the document, and not covering all the points sequentially...
e.g. suppose Sony Ericsson has come up with a new model again and it is giving a user manual along with the cell..
Then shd the user-manual come up with the explanation of flagship feature fst..which cld be say anything..sound quality, improved bass effect of their walkman series ..

or it shd be just a reference in the index..with the basic features coming fst like how to make a call, sending sms../ to change themes/screen savers..

please pour in ur suggestions!!!!!

3. Domain Knowledge:

This is absolutely a must.Just imagine, a doctor is coming up with a white paper on say "Intrinsic benefits of eating Chavanprash". Writer has to be atleast at the same level as the reader..Always analyse ur audience could vary from your client, who is a technical expert to a layman who is the end-user of ur application. Avoid giving basic information if the audience is at the same level.

Also , the information you provide should not be insufficient or incorrect.Always ensure to give references for the info you are not planning to cover but is in the scope of your doc.

Best remedy is to read your doc. again with a fresh mind in a day or 2.You will find so many areas to improve urself, this tip works more like new set of eyes reading it.

Never forget to get your doc. reviewed by a person more technically sound than you in that domain.Trust me, it really helps, opens up new areas to ponder upon..discard all ego/emotional/status barriers..and always try to follow this tip..

always think "WHY does the reader want to read this document!"

4. One-time OR a reference document:

Understand that you have to first prepare your reader for what's coming up.Don't we take an overview of any doc. fst before going into details..
Reader will always skip certain sections in the doc.

As an instance, suppose there is a doc. analysing a new feature, say which talks of transmitting Abis traffic on IP instead of conventional E1 lines..
The engineer as well as the manager will be interested in reading your doc.

Here you have to make sure, that you give references to various sections and not just describe everything in one go, so that readers can easily skip uninteresting topics, and at the same time you don't break the user's flow of understanding tasks/layers..

This is really important not to break the chain in reader's mind, otherwise the reader might start feeling irritated and when you present him/her a document next time, he/she might read your doc. with a pre-judiced mindset.

Say if it is a just one-time to be read doc., try to make it as catchy as possible... it is more or less a do or die situation..
But if it is a reference doc., say a doc which talks abt all the features of Boeing 777 aircraft, make it more systematic.
Always ensure to add a search engine in such a huge doc, where the search algorithm is such that it takes minimal time to access a particular attribute.

4. Avoid flowery language

Try to avoid gender-specific language wherever possible, though i must admit i have also used it in this post of mine!

And in the process of avoiding gender specific language, don't make it passive and never write in third person. l was atrociously puzzled when my trainer told me all these points in a go..and there I was, asking her to explain again an already elaborated instance :-D

Say you are explaining how to install a software using a CD, in such a case, always start with a verb; or to be precise, talk to your users.If plural is required , use "They". e.g. if xyz problem occurs, they can do this."

A spelling or grammatical mistake can play havoc to your doc's image and ultimately your image :-(((

Let me recall an interesting sentence passed by a professor, void of any punctuation.Let's see how both the genders deciphered it:

(F) Women: Without her, man is nothing.

(M) Woman without her man, is nothing.

Lastly, remember that an inappropriate style of writing will always make the reading boring or irritating, howsoever rich your content be..Well, to enhance it, you have to practise my friend..

I had come with a highly content rich user-guide last Dec, but guess what, my client did not even read it once because he did not like my template :-((

would like to quote a statement passed by none other than golf champ, Tiger Woods:

"No matter how good you get, you can always get better and that's the exciting part. "

5. Make MS word your friend not foe

Till date, MS word is the most feature-rich and user-friendly editor available. Try to learn and implement MS word tips as much as possible.

Learn how to fiddle around happily with tables, figures, cross-references, visio objects, track changes, header, footer, templates, toolbars, page-breaks, comments, embedded objects, bookmarks...

Try to understand why your doc. crashes at times..It could be because of memory-overload..Try to reduce resolution of visio objects in such a case.. Some companies have started using "doxygen"; it is a freeware tool to prevent excessively loaded doc. crash. This tool loads all the links only when clicked, that too in HTML format, unlike in MS word which by default loads all the embedded objects in one go.

Well, for all those who have managed to read till this point, here is a golden advice for you, given by my trainer:

"Write documents that you would like to read."

free website hit counter

View My Stats

Friday, February 23, 2007

Thoughts at their Best

  • "You can't be a friend until you learn to share.. "

  • "Your life is like a mirror, if u face it smiling, it smiles right back "

  • True friends stab you in the front.

  • Bad officials are elected by good citizens who do not vote.

  • Laziness is nothing more than the habit of resting before you get tired

  • Standing for what you believe in regardless of the odds against you,
    and the pressure that tears at your resistance Courage.

  • Keeping a smile on your face when inside you feel like dying,
    for the sake of supporting others Strength.

  • Stopping at nothing and doing what's in your
    heart that you know is right Determination.

  • Helping a friend in need, no matter the time or effort,
    to the best of your ability Loyalty.

  • Holding your head high
    And being the best you know you can be when life
    seems to fall apart at your feet,
    Facing each difficulty with the confidence that
    time will bring you better tomorrows,
    And never giving up... Confidence.

  • Hold your head high
    and make your life better every day!

  • Our deepest fear is not that we are inadequate
    Our deepest fear is that we are powerful beyond measure
    We ask ourselves who am I to be brilliant, gorgeous, talented and fabulous
    Actually, who are you not to be? - Ruchi

  • If one finds life meaningless, one is almost not fit to live. - Albert Einstein

  • When the code and the comments disagree, both are probably wrong. - Norm Schryer

  • Never judge a book by its movie. - J.W. Eagan

  • There are 4 things you can't recover:

The stone... ....after shot!
The word... ...after pronounced!

The ocasion... ...after lost!
The time... ...after gone!!

  • Don't let the setting Sun with it's golden hue,

    stir dark memories of the night in your heart,

    'coz, a dusk here means a dawn somewhere too...

  • Every man dies, but not every man really lives!

  • The way to love anything is to realise that it may be lost. -Gilbert K. Chesterton

  • The best way to cheer yourself up is to cheer somebody else up - Mark Twain

  • For today and it's Blessings, I owe this world an attitude of gratitude. -Clarence E. Hodges

  • A commitment has many expressions. -Ace Jewels

  • Impossible is often untried !!-Gaurav

  • Fragrance always remains in the hand that gives the rose~

  • Ladders remain where they are, but people climb on it.

  • No matter how good you get, you can always get better and that's the exciting part. - Tiger Woods

  • A secure network cannot guard an insecure application -AztecSoft

  • The only light on the future is faith and experience.

  • If you want something you never had, do something you have never done.

  • A guy who cannot believe in himself is wasting his hard work.

  • To laugh often and much;

to win the respect of intelligent people and the affection of children;

to earn the appreciation of honest critics and endure the betrayal of false friends;

to appreciate beauty;

to find the best in others;

to leave the world a bit better, whether by a healthy child, a garden patch or a redeemed social condition;

to know even one life has breathed easier because you have lived.

This is to have succeeded. - Ralph Waldo Emerson

Wednesday, February 21, 2007

Barney's Big Funtime

Last saturday (17th Feb, 2007), I had gone to visit my sister.To my sheer surprise, my sis told me that she had booked tickets for some cartoon show. There we were, a band of 4, me, my sis and her 2 lovely daughters...all excited to watch live in action, one of the kids' favourite cartoons!

Well this toon was a very famous character "Barney", a loveable purple dinosaur who comes to life through children's imaginations. Barney and his entire team of 5 were supposed to perform live for the first time in India at SiriFort auditorium, New Delhi.

It looked like the priviliged class of Delhi was leaving no stone unturned to hone their kids' skills right from their pre-nursery times! The show had to commence at 4 and for almost half an hour, we were absolutely clueless about the entry point..

At the security gate, there was so much of hustle bustle, signifying confusion in the mind of elders and loads of excitement amongst the kids..The back side of the ticket showed certain terms and conditions. The most striking one stated that no cameras, handbags, purses and mobile phones were allowed in the auditorium..

Naive people like me thought of hiding their cell phones in the innermost compartment of their already stuffed purse. My sis concealed hers inside my niece's jazzy purse!!!
really sorry, for revealing some customized secrets in public..But lets hope, authorites start coming up with some what lenient policies in the near future!

Barney and his co-toons entertained the audience approximately for 1 hour. Children were immensely enjoying the evening..they were seen clapping, dancing, singing, tapping their toes and trying to catch up with Mother Goose who was reciting their all time favourite poems.Their guardians looked more contented with the fact that it had been a successful experiment since their wards were enjoying from the core of their heart!

Event was presented by Lilliput kidswear - "WEAR IT. LOVE IT! and promoted by Pogo and Jbc (Just because it's children).Message was promoted by HT (Hindustan Times) and radio partner "RADIO ONE FM 94.3".

Audience loved oodles of exciting events at the stalls as well.There was a wonderful free of cost photo session, just for kids..My lovely dolls, (my nieces) looked so innocent and beautiful when clicked, while carrying a flower bud in hand..How much i wished to be a child again at that moment!

Another stall displayed the flowcharts of various programmes held at Julia Gabriel centre, a centre which believes in creating confident communicators. It is a multi purpose playclub for children aged between 18 months to 12 years..lucky are those chaps who have got admissions there.For people who are still searching their address, let me give some pointers:

Hauz Khas Delhi: Ph: 26602825-29
2, Padmini Enclave, Hauz Khas , N Delhi-16

DLF Gurgaon: Ph: 5056511-18
45, Kusum Marg, DLF Phase -1, Gurgaon

I must admit, initially I was a bit reluctant abt enjoying the show, but eventually this show had been quite successful in bringing out the cute & fervent child in me..In the end, would like to quote Barney's theme song, kids just love it:

I love you,
You love me,
Ours is a happy family!

With a great big hug,
and a kiss coming to you,
won't you say you love me too!

I love you,
You love me,
We are best friends,
as friends should be!!

free website hit counter

View My Stats