Participative Help Design

Participative Help Design I used a weblog script to create online help for -uh- using weblogs. I used a plugin to pull help topics as alphabetical links. The script has in-built search. So, there, I had an index and a search. And I left the ‘Comments’ feature alone. And guess what, I had users commenting […]

3rd STC Chennai Meet this sunday.

3rd STC Chennai Knowledge Sharing Session this sunday, April 4th. This month’s knowledge sharing session will be held this coming sunday, april 4th at Cognizant’s office at 10:00 a.m. Please do spread the word around. Day & Date : Sunday, April 4, 2004 Time : 10 to 11 a.m Venue : Cognizant Technology Services (CTS), […]

Localization and Internationalization

Localization and Internationalization Internationalization: Writing in a neutral, simple language so that the document can be translated to other languages without much trouble. There are standards for it like the The European Association of Aerospace Industries (AECMA) Simplified English. The AECMA Simplified English (SE) dictionary is defined in the AECMA standard PSC-85-16598 developed by the […]

Next STC Chennai Meeting On March 7 : This will be the second knowledge sharing session. The first meeting was a wonderful success and we hope the second one will be even better. Take a note of the details.. Day & Date : Sunday, March 7, 2004 Time : 10 to 11 a.m Venue : […]

I am engaged I got engaged to Chitra on 25 Jan 2004. I was busy traveling and making arrangements. The other news is that I have published my first novel; visit http://sunnu.blogspot.com to read 10 free chapters. If you like what you read go right ahead and buy the novel at http://cafeshops.com/sunnu. I will resume […]

Chennai Tech Writers Mixer on Jan 25 : Calling all Tech Writers in Chennai for an informal Mixer on Jan 25th. It’s a great opportunity to network with our fellow tech writers from different companies in Chennai. The Mixer aims to be a nice watering hole for chennai tech writers to meet up and share […]

Usability Testing of Your Documentation Yea, it is possible. Let’s say you have created a user-guide. The user-guide is aimed at helping users in performing various tasks on the product. Choose a representative user (anyone, even your mother-in-law is all right). If you can’t recruit a user read List-item: Ask the user to perform tasks […]

Microsoft LongHorn Help The next generation of the Microsoft Windows operating system, codename “Longhorn”, promises to raise the standard for performance and innovation. The Windows “Longhorn” Help system is designed to greatly improve the user assistance experience in Windows. “Longhorn” Help includes the following features: A new structured authoring model enables Help authors to create […]

How to become a technical writer I got a few mails from aspiring tech writers asking how to be a technical writer. I’ll assume that you guys are asking me ‘how to get a technical writer’s job’. Please note that the content below is inspired by what little I know; don’t go by it word […]

Escape From the Grammar Trap by Jean Hollis Weber Too many editors focus on the details and don’t pay enough attention to the bigger picture. Editors can–and should–add even more value through substantive, technical, and usability editing. (…via TECHWR-L) write to me: Suman@sumankumar.com