RSS

Our First Technical Writing Contract

04 Mar

As I mentioned earlier, we started TASC as a technical writing and training company. Our early days were occupied in training individuals on Microsoft Windows 95,  Microsoft Office 95, PowerBuilder, C, C++, Microsoft Visual Basic, and the like. It was after a couple of months of starting the company that we got our first technical writing contract; and what a contract it was!

It was from a company based in Gujarat that was developing an RDBMS. They were looking for comprehensive technical documentation for their product. One of the directors of this company knew us from the time we authored some books on PowerBuilder and he approached us to create the documentation for the RDBMS.

We had to create some 12 manuals on topics ranging from installing and configuring the RDBMS to SQL commands and functions. We had 7 months to do it in. The development team was based in Gandhinagar while the headquarters were in Mumbai. So we travelled often to Gandhinagar (fly to Ahmedabad and travel by road to Gandhinagar by road) for meetings with the development team and for review meetings.

Aldus PageMaker (now Adobe PageMaker) was the mandated tool. At first, we decided to directly author in PageMaker, but soon realised how painful that was. So, we employed a DTP operator to layout the manuals while we swtiched to the easier Microsoft Word for authoring. FullShot was the screen capture tool.

Those were the days of dial-up internet with a princely 9.6 kbps data transfer rate and our files were gigantic. So we used printouts and floppy disks to deliver documentation for review. This typically involved a late night run to Mulund, a distant suburb of Mumbai, where the client had a sales office for another of his businesses. There were people who travelled to Gandhinagar every week from here, and they would carry printouts to and from the development team.

Those days Mulund was not the upmarket place that it is now. It was known for its salt pans, “desi daru” bars , and industrial estates.

On other days, we used the famed angadia service that delivered anything from documents to diamonds overnight to Gujarat. It was a boon when First Flight Couriers started deliveries to Gandhinagar.

Fun and games aside, it was an exhilarating if exhausting few months. We were given every facility we needed to get our work done. Be it access to people, books, equipment, travel support….

The client trusted us to know what would be required of documentation for such a product. We read manuals from Microsoft and Oracle to understand how manuals were written, what should be included, how should the manual look… We learnt everything there was to learn about RDBMS’s. Everything was a discovery. And we learnt such a lot.

Our first task was to explore SQL inside out. We did that by installing Oracle, and spending days and nights testing queries of all sorts. We soon saw SQL joins, unions, and functions in our sleep. Sleeping Smiley

Even today, I can write the most complex of SQL queries with ease.

While we may not have realised it then, for us, living up to the faith reposed in us became the thing. And we did.

The sense of accomplishment when we heard that the documentation passed a certification process initiated by a major US-based venture capitalist is indescribable.

Advertisements
 
5 Comments

Posted by on March 4, 2012 in Technical Writing

 

Tags: , , , , , ,

5 responses to “Our First Technical Writing Contract

  1. lopascribes

    March 4, 2012 at 2:35 PM

    You are a wonderful story teller! This one, just like the previous one kept me captured right till the end.
    “Even today, I can write the most complex of SQL queries with ease”, this reminded me of the SQL paper that I never liked in my graduation. Even if it’s regarded as the most simplest of papers in IT, I had to scratch my head a million times before writing a complicated query. 🙂

    It does take a lot of courage, and a whole lot of faith to stand by what one wants to do in life. Your story gives me that kind of faith to keep doing what I like most – writing!

    Thank you for sharing this!

     
  2. Vinodh NV

    March 5, 2012 at 3:03 AM

    Well Aruna,

    Each section of your blog seems to be unearthing your undying passion and steely determination. Certainly motivating for those who wish to make a mark in this field in today’s technologically advanced world.

    Vinodh.

     

Hey! Let me know what you felt on reading my blog. :-)

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

 
%d bloggers like this: