Saturday, December 22, 2007

Straight from the Assistant Organizer's Desk

Dear Readers,

At the very outset let me wish one and all seasons greets for a fantastic Xmas and a prosperous 2008. Don't forget to invite me for the new year party :) I promise I am going to behave well :)

Coming back to the subject this is the time of the year when I usually look back at the activities that Bangalore Technical Writers Meetup carried out for the year 2007. Trust me, we had lots of sessions and activities this year. But I'll keep the email short and crisp as some usability guru opined, "write less, illustrate more".

Let me begin: we had 9 sessions in the year 2007, and the topics covered were as usual varied and interesting. Topics right from "API Documentation" to "English Grammar" and "HTML Programming" to "Comics in Tech documentation" were discussed. We also had tools session on FrameMaker and Epic Editor.

This year also witnessed an association in the form of premier Society for Technical Communication- India Chapter getting associated with the Bangalore Technical Writers Meetup. STC India sponsors the Bangalore Technical Writers Meetup now.

We at the meetup have had always tried to spread technical communication knowledge to various quarters and have not limited ourselves to just corporate offices and institutes. I am glad to announce that we are getting invites from certain colleges to organize technical writing sessions at their premises. Incredibly encouraging.

Networking still seems to be a rage in the meetup, and this month we saw a turn around of more than 50 plus people. That's great! Also, considering that the meetup membership list has grown upto 652 (till last count), the day is near when we will touch the magic mark of 1000 :)

I still get queries as to the registration amount of the Bangalore Technical Writers Meetup. Let me clarify here: This Bangalore Technical Writers meetup is absolutely FREE and no registration charges are required for participation. This is something that we organizers have always maintained, and we will unless and until we have some unavoidable circumstances to face. So, feel free to just walk in anytime at the meetup, and we won't mind having a coffee with you :)

I also look forward to have you as a speaker for the meetup. If you have any interesting topic to speak on (pertaining to technical writing), just send across an email to me and CC it to Saravanan ( sara.techwrit@gmail.com) preferably before the 5th of every month, and we will be delighted to have that as an agenda for the meetup. However, please see that you give me some time to organize the sessions. I am sure you agree to it, meetup takes a bit of time :)

This email is incomplete if I forget to mention the constant support that we received from the entire technical writing fraternity, and trust me we are more than delighted. Couple of you suggested that the meetup should take some initiative to make younger generation more aware about Technical writing as Career, How to be prepared and how they can move on. Well, we will keep that in mind, and will organize sessions soon on that.

Looks like I have made quite a few sleepy by now :) Anyway, thanks for your constant encouragement.

This is your Bangalore Technical Writers Meetup. Make it the best.

Once again Merry Xmas and a Happy New Year!

Friday, December 07, 2007

Dating a RoboHelp Project


Things are pretty eventful in the end of the year 2007. I was slowly wondering after the Annual appraisals that nothing more wrong could happen in my life when I was startled by this. The date was day before yesterday (December 5th 2007), exactly a month remaining for my next birthday.

This is a project that involves me documenting a part of an Admin module, and I had finished it with great satisfication, when suddenly tragedy struck in the form of RoboHelp struck. Couple of things that happens when such things happen- agitated, furious anger and what not. I was feeling all the same but more because this was the first time something such as this had screwed up. I can't explain what anxiety I had developed. Can you believe a mamoth project of more than 50 topics gone for a toss?

I dialled in some no's for help but none could help. I emailed to a mailing list but things didnt sort out. And then, I started drinking water and thought of what could happen if wrong. I did some troubleshooting lessons, uninstalled the software, renamed the project files but none could favor me.

The next morning, I reached office and first things first checked if the project was opening in other systems but it showed the same errors. I called up a senior writer who showed me a ray of life and said "don't worry! it can be sorted out". Well, I must thank her for taking time out and helping me out in this.

Here a couple of things that you should when you get screwed up with a RoboHelp project:

Don't panick; it doesn't help.
Go to the project folder; rename the .mpj folder and check if it opens post renaming.
If NOT, check the .xpj file and try opening it. 90% of the time it should open.
If NOT, than delete the .CPD file and try opening the file again
It should work. Again try reimporting the html topics and create the project.
If nothing works, than you need to pray that atleast the HTML topics that you have created in are all order.