Technical Writing, and Documentation Service Provider

How I Became a Tech Writer

As a child, I dreamed of being a pilot, and as a young boy I dreamed of being a doctor, but there are dreams that cannot be and storms we cannot weather. 

I am now a Tech. Writer in the business of creating content, knowledge base, information architecture, and evangelising products through blogs, and white papers. I communicate technical knowledge, arousing the reader's curiosity. The process of learning excites me. I love to research and convey complex information in a simple, understandable, and user-friendly format, and capture the interest of readers, so that they can can easily navigate their way through the maze of complex architecture. I am energised by the steady and deliberate journey from ignorance to competence. 

As a writer, I delve in three dimensions - the first dimension where I put myself into the shoes of target readers, gauging their levels of expertise - novice to an expert; the second dimension where I spend my time researching and interacting with applications; and the third dimension, where I craft my writing until it's perfect. 

After a piece of writing has been developed, I make it better, cleaner, and more efficient. I take the feedback to polish it further and make it the best possible version of itself that it can be. Check out this video that highlights the importance of feedback.

During my school days, I was a voracious reader. I read comics, and stories from Enid Blyton, Hardy Boys, and Reader's digest.

My goal was to rank among the top students in the class. I performed well in my studies. On rare occasions, my rank slipped below my expectations, but I always bounced back. Life’s biggest goals were finishing exams, scoring well, and traveling to my hometown - Kottayam, an adventurous journey by train for three days and two nights, passing through hills, mountains, rivers, fields, and tunnels. 

After X, like every student in the science stream, my goal was to be a doctor or an engineer. I let go of all extracurricular activities and focused only on my studies. In XII, most of us had private tuition on top of what school teachers were already providing. But things didn't work out as per my plans. I did not qualify for an Engineering or Medicine seat. Based on merit, I enrolled for a bachelor's degree in Science from the M.S. University of Baroda. 

While in the first year, I still pursued my dream. I studied for medical entrance while I was doing my BSc. but because of clashes in the examination dates; I let go of my dream and carried on with a renewed mind. I scored 62% in the first year and expected a similar performance in the second year, but to my dismay; I scored only 52%.

During the last year of BSc., I wanted to pursue Masters in Computer Applications (MCA), so I started preparing for the entrance test. To qualify for the entrance test, I needed to score at least 60% in the last year, so that the average of the second and the third year comes to 55%. By God's grace, I scored 62% in the last year. 

I appeared for the MCA entrance examination in May 1998. It was a miracle from God to see my rank in the top 10. 

When I attended the first semester classes, the subjects were different from what I had studied until then. The programming languages were foreign to me. The only subjects that I was comfortable with were Maths and Economics. During the first year, I performed badly in programming languages. But from the second year onwards, my grades improved. In the last semesters, I did projects at ABB and Railway Staff College, using Visual Basic and Oracle. It was during that time I was exposed to the 'Internet' and got fascinated with Yahoo Messenger. I could interact with people across the globe. In the overall three years of the MCA curriculum, I scored first class. Thank God for His mercy!

During college days, every student's goal was to get through campus interviews. In the fifth semester, of 2001, companies like Amdocs, TCS, Patni, Wipro, and MBT hired more than half the class of our MCA graduates. But in the latter part of the year, because of the dot-com bubble burst coupled with the World Trade Center attack, companies canceled or postponed their job offers. It was a blow to those who were given job offer letters. Miraculously, I got into a US-based startup company - Amtel Security Systems. I was interviewed by Suresh Gajwani, the founder when he was on a visit.

Shortly after I got into the company, I learned that my primary responsibility was not coding but writing product documentation, providing technical support, gathering customer requirements, writing persuasive RFP responses, assisting sales in identifying customer's business requirements, and delivering technically correct solutions, testing, and even issuing purchase orders for controllers and chips. I had hands-on experience with almost everything except coding. I loved the RFID and security products and enjoyed my work there.

I worked at Amtel for two-and-a-half years, but there was no salary increment. I decided to change the company. By this time, my programming skills got rusted, and I lost my passion for coding. The only option I had was to work as a Testing Engineer or Sales Engineer. While browsing for jobs in newspapers, I came across a post of a Technical Writer that caught my attention. Until then, I was not aware of a post called Technical Writer. 

I gave two interviews, one with Impetus Technologies, in Indore, for the position of Software Testing Engineer, which required me to travel to Ahmedabad, and another with Zensar Technologies for the role of Technical Writer, which was conducted over the phone.

While I was in Kottayam for a vacation, I got an offer letter from Impetus. After reaching Baroda, I put forth my resignation and joined Impetus, Indore, in Feb 2004 as a Software Testing Engineer. That was the first time I started living independently away from my parents. The company provided hotel accommodation for a week. 

Two weeks later, after joining Impetus, I got another offer from Zensar Technologies, for the post of Technical Writer with a better salary. I was in a dilemma about whether to accept the offer since I was happy with the role of Software Testing Engineer. After much pondering, I decided to go for Zensar's offer that established my career as a Technical Writer, a road not taken by the MCA graduates.

Two roads diverged in a yellow wood,

And sorry I could not travel both

And be one traveler, long I stood

And looked down one as far as I could

To where it bent in the undergrowth;

Then took the other, as just as fair,

And having perhaps the better claim

Because it was grassy and wanted wear,

Though as for that the passing there

Had worn them really about the same,

And both that morning equally lay

In leaves no step had trodden black.

Oh, I marked the first for another day!

Yet knowing how way leads on to way

I doubted if I should ever come back.

I shall be telling this with a sigh

Somewhere ages and ages hence:

Two roads diverged in a wood, and I,

I took the one less traveled by,

And that has made all the difference

At Zensar, I wrote documentation for the UML tool - BluePrint Foundry, created help file (CHM format) using a freeware tool “Cheetah”, and wrote ADDL syntax Programmer’s Guide.

In Oct 2004, I received an email for a Technical Writing position with Samsung Electronics in South Korea. It was a marvelous opportunity. I boarded a Jet Airways flight from Pune and landed at Bangalore airport just in time, to attend the interview. From there, I took a taxi to the Samsung office. When I entered the meeting room, I was surprised to see a room full of Korean nationalities. The interview went well, but I was not sure of my performance.

In November 2004, by God's favor, I received a confirmation letter from Samsung about my selection. During the same time, I received another offer from a company in Pune, but I decided to join Samsung Electronics. I resigned from Zensar Technologies on 10th Jan 2004.

I arrived in S. Korea on 21st Feb 2005. It was one of the coldest days with temperatures below minus 15 degrees. You can read about my experience here http://www.thomasabeesh.com/2012/07/14/memoirs-of-south-korea/. I was with the Flash Management Software group, Memory Division, responsible for creating product documentation and white papers for Samsung's XSR, Whimory, RFS, and TFS4 file systems.

The best thing about working at Samsung, Korea was that they provided a fully furnished flat, festival bonuses during Chinese New Year (Feb) and Chuseok Festival (Sep), performance bonuses equivalent to 2-3 months' salary, year-ending completion bonus, two-way flight tickets to your home country, relocation allowance, and zero tax for foreigners with Master's degree and 3+ years of work experience. 

A view from my flat in S.Korea

I enjoyed the weather in Korea especially the snow in winter. Some of the beautiful places I love there are Jeju, Busan, and Seoul. The company provided free training to learn the Korean language.

When I joined the Memory Division, it was the most profitable division. But in 2009 due to the great recession, the company suffered losses, and the management decided not to renew the contract of foreign engineers. Most of my colleagues opted to work in Samsung India, Bangalore.

Before the turn of these events, I wanted to work in the UK. So, in October 2008, I applied for the Tier 1 work permit (HSMP), and within a week, it was approved. I could stay in the UK and look for a job without requiring any company to sponsor my work permit. 

After my contract with Samsung, I went to Cambridge, UK in March 2009. (Click here for pics). 

But it was an economic recession there too. I stayed with an African family for a monthly rent of 350 pounds. It was through them; I got the chance to attend the African-American Worship service at the City of David Church - one of the most vibrant people I ever met in my life. While staying in the UK for three months, I attended three interviews in Bristol and Cambridge, but with no success. I decided to return to India to continue my career as a technical writer. On June 2nd, 2009, I left Cambridge and came back to my hometown - Kottayam. In mid-June, out of blue, I received an email from a consultancy in Singapore for the post of technical writer with Savi Technology - A Lockheed Martin Company. 

Singapore was never on my radar. I had never dreamed of working there. God's plan was different.

Singapore

There were five rounds of telephonic interviews with the Information Development (ID) Manager, Principal Writer, ID Director, Product Manager, and Vice President of Savi, Singapore. By God's favor, the interviews were successful, and I was selected to work in Singapore for Savi Technologies. I was supposed to join on July 15th, 2009 but later I discovered that I could not travel since my passport validity was less than six months. I applied for the tatkal passport in Kochi and got my passport after seven days. It took another one week to get my employment pass from Singapore MoM.  I was provided the flight tickets and two weeks of accommodation at Spottiswood Park, Tanjong Pagar. On July 26, 2009, I arrived in Singapore and joined Savi Technologies. It was my first experience working in an Agile Scrum environment. I wrote SDK Installation Guide, User Guides, Installation Guides for Savi’s SmartChain RFID applications, using  XMetal as a Single-Sourcing tool for generating content in various formats such as Online Help, CHM, and JAR files, and performed quality assurance and usability testing in the process of producing user documentation. 

After working there for a year, in August 2010, due to the company's financial performance, the US office decided to outsource the development work to the Pune office in India. Nobody expected the closure of operations in Singapore. The employees were given the choice to work in India, but nobody opted for it. In the middle of September, through God's favor, I received two offers, one with Philips Electronics and another with Tagit Pte Ltd, for a one-year contract. I was in a dilemma to choose the company since both offered the same pay package, but I decided to go for Tagit. My responsibilities were to create user guides, installation guides, and training materials for the mobile banking application, Mobeix. 

In August 2011, history repeated itself. Because of the financial situation, Tagit started cutting staff, and I was laid off. Since I was employed through consultancy, they tried their best to find another client but had no success. Meanwhile, I applied for PEP and got approval within three weeks. I could work for any company in Singapore without requiring any sponsorship.

In the first week of October 2011, I got an interview call for a technical writing position with PayPal, an eBay company, at Suntec City, Singapore. It was a six-month contract position. There were four candidates vying for the same post. On Oct 10, a day before my birthday, I got confirmation about my selection. Praise God. I was responsible for creating API documentation for their SOA-based financial instrument services. 

On February 29, 2012, I received a call from the consultant informing me that my last working day would be on April 16, 2012. I was taken by surprise since I expected an extension of my contract.

I started applying for jobs. In the third week of March 2012, I got an interview call from JDSU Test & Measurements Singapore Pte Ltd, a US-based telecom company. I attended the interview and within two weeks, I received confirmation about my selection. All praises to my Lord and Savior Jesus Christ. One thing I know for sure, God can do it again and again when you call Him. After my selection, PayPal wanted to extend my contract for three more months, but it was too late.

After working at JDSU for three years and two months, the company split into two disparate groups, Viavi Solutions, and Lumentum. Because of the split, it carried a burden of 50 million USD. To manage the expenses, JDSU decided to close the R&D division in Singapore, phase by phase. I was given a month's notice period. The company provided the relocation expenses and three months' salary for the number of years I worked.

A week before leaving Singapore, I got an interview with NextLabs, through a referral from an ex-colleague. I cleared the first round, which comprised a written test, an interview with a product lead, and with the director. The second round was a telephonic interview with a senior writer in the US. I cleared that and then there was a third round of telephonic interview scheduled on 29th July with the VP of the R&D division from the US. 

I also had an interview scheduled with another company on the 30th of July, but my visa was valid until the 26th of July. I went to ICA Singapore, to extend my visa, but it was denied.

While in India, I completed the third round of telephonic interviews and submitted three references from my previous company as per the NextLabs HR policy.

After two weeks, I received confirmation of my selection. The company applied for my Employment Pass, which was approved within a week. Praise God for His favor. After I joined the company on 26 August 2015, I came to know there were other candidates vying for the same post. 

Life was going smoothly. I was enjoying the workplace, people were cooperative, and there were new products coming up that needed documentation. We went for occasional team outings and were having fun. In March 2017, we got our salary after a delay of 2 weeks. It was the first sign of financial trouble. During the quarterly all-hands meeting in May, the CEO indicated the possibility of pruning the workforce if the situation didn't improve. On June 7th, when I entered the office, the admin was not in her seat. I came to know she was let off the previous day. At 1 pm, as I was about to go for lunch, the director called me to a meeting room. I was informed that it was my last day in the office. With all the leaves and 2 week's notice period, my official last day would be July 4th. I would get my salary until July 4th, but I need not come to the office. I was calm. I knew God was in control and something better would turn up. A few other employees were also given the termination letter.

I started updating my resume on the job sites. I attended 5 interviews in a span of 2 months. Some interviewers gave high hopes as if they were about to hire me the next day, but at the last moment, they backtracked.

Through a referral, I got confirmation from Xchanging, a DXC Technology company, but they wanted me to move to Kuala Lumpur, Malaysia. I gave my consent for relocation and they applied for my EP. Two weeks later, I got an interview offer with Veritas Technologies, in Singapore for a one-year contract via consultancy. They confirmed my selection after a week. I had to renege on the Malaysian offer, but it was cordial. I had to leave Singapore as my pass was about to expire. While I was in India, the company applied for my EP on 3rd August. MoM approved the application on the 25th, and I joined the company on the 30th of August.

At Veritas, my primary responsibility was to create the documentation for the GovTech Singapore, Backup-as-a-Service Cloud project. I visited the GovTech Data Center daily and interacted with stakeholders and engineers to get the doc feedback and project updates. The deadlines were strict as it was a government project.

GovTech Data Center

While I was still with Veritas, in Jan 2018, I saw an ad for a technical writing position with Grab. I applied via LinkedIn. There were 2 rounds of interviews. In February, I received confirmation about my selection. I submitted my resignation, gave 1 month notice period, and joined Grab in April 2018! Glory to God!

Grab had just merged with Uber in March 2018. I was the first technical writer to join. In a span of three months, other tech writers joined. The engineering manager who recruited us had previous experience working at Uber in the United States. Drawing from his familiarity with Uber's approach, he decided to try a similar strategy at Grab by bringing in technical writers. Consequently, all the writers were assigned to various teams within the organization.

 In the initial days, it was a bit chaotic. I was confused as, to why we were hired. Our documentation users were product analysts, data scientists, backend engineers, and mobile developers within Grab. This was my first experience writing for internal users. In all the previous companies, I wrote for external users. After 6 months, engineers started seeing the value that we brought to their teams. We designed the structure and breathed life into the documentation. We published engineering blogs, newsletters, and technical tutorials in the Google Codelab format. 

The office at Marina One was awesome. It was like being on a cruise ship with a sea view all around.

Life was going smoothly until Covid-19 stuck. In March 2020, our team was about to onboard a new Technical Writer. With a view of the looming recession, there was a sudden announcement of a hiring freeze. 

There were regular town hall meetings via Zoom with Grab's founders and HR heads. In May, they gave a hint of layoffs. And in the second week of June, just a few days before the government's decision to lift the lockdown, the management decided to strike the iron while it was hot. A total of about 360 Grabbers were impacted and that included me and another writer. 

Love this farewell card from Grab colleagues.

Paul writes in Philippians 4:11-13: Not that I speak in regard to need, for I have learned in whatever state I am, to be content: 12 I know how to be abased, and I know how to abound. Everywhere and in all things I have learned both to be full and to be hungry, both to abound and to suffer need. 13 I can do all things through Christ who strengthens me.

Technical Writers are hired for a reason and for a season. As soon as the company's finances head south, there will be layoffs. At such times, God works in a mysterious way. 

Miraculously, I got a technical writing opportunity with Autodesk Singapore. There were 3 rounds of interviews and within a week got confirmation about my selection. My EP was approved in a week. It was a miracle from God to get this opportunity during the Covid period especially when the economy was down and there were layoffs in many industries. Initially, it was a contract position for 6 months. During this period, in appreciation for my work, I received the Autobucks Award. My contract was extended for another 6 months, and later it got extended for 1 year. 

I was looking for a permanent position. I started applying for jobs and got the breakthrough in March 2022 with Prive Technologies, a fintech company with headquarters in Hong Kong. There were 3 rounds of interviews with the HR, CTO, and CPO. I received the offer letter in mid-March and I promptly resigned from my position at Autodesk, providing a one-month notice period. Interestingly, shortly after my resignation, Autodesk extended an offer for a permanent position. Nevertheless, I decided to join Prive Technologies, as my application had already received approval from the Ministry of Manpower (MOM).

But it was one of the most imprudent decisions that I ever made rejecting the Autodesk offer. 

I joined Prive in May 2022. However, just a month later, the company faced an unexpected financial setback when a few investors withdrew their support. The repercussions were palpable as some of the colleagues were laid off. During this challenging period, the CTO happened to be in Singapore on a business trip. While having lunch together, he assured me that my job was secure and the company valued my services.

I authored documentation covering various wealth management modules and their respective features, implemented the documentation process for monthly release notes, and created a portal showcasing user manuals, API documentation, training videos, and Release Notes. Things were progressing smoothly. In December, I took a holiday to visit my parents, it was my first visit in three years due to the Covid lockdown.

In June 2023, both my reporting managers, the CTO, and the CPO, resigned due to a conflict with the CEO. Just a week after their departure, I received an email from the HR informing me about the redundancy. I was confident, God was in control. Job opportunities were scarce and most openings were limited to locals or permanent residents. The government policies made it difficult for companies to hire foreigners. I left Singapore and arrived Kerala on 1st Sep, 2023 with my wife and kids. It was a new season in my life. I attended few interviews and reached out to former colleagues in different companies, but nothing seemed to work out. I thought with my overseas experience, it would be easy to get a job in India, but I was wrong. Unlike Singapore, the competition in India is very high, there are hundreds of applicants vying for the same position.

In November 2023, I finally got my breakthrough with IBM, Kochi. This time I applied directly through the IBM website and got shortlisted. Interestingly, I had previously applied for the same position at IBM, Bangalore through a referral, but that application didn’t progress.

I gave a written test followed by three rounds of interviews. On November 18th, I received verbal confirmation of my selection, and got the official offer letter after two weeks. Thank God for His favor!!

Why Hire Me?

I am surprised to see advertisements from high-tech companies, looking for Technical Writers with just 5 to 6 years of experience. I believe it is because of the cost factor to hire experienced writers.  

Technical documents are designed to convey information clearly and persuasively but there are no definite, measurable standards to judge. It's possible that writing can be error-free and still not communicate effectively. There are no algorithms for writing. It takes years of experience and mentorship for writers to come out with quality documentation. Check out this link about the impact of good documentation on the organization's performance.

The key to writing a good document is that it has to be a good experience for both - the writer and the reader. The satisfaction of the writer and the reader are interwoven. 

Technical Writing is an art and science. We practice our craft to service the reader. We don't expel raw material; we transmute it to provide what the reader needs. Like any art, writing involves collaboration. 

In case of REST API documentation, should we keep it concise with just a one-liner description? Here’s my take: While minimalism has its merits, applying it here results in poor UX. For REST APIs, the documentation is the interface—the only interface. Developers don’t have a visual UI to explore or experiment with, so the documentation must provide all the information they need to understand and use the API effectively. Why is comprehensive documentation essential for REST APIs? REST APIs lack a visual interface. Developers depend entirely on the documentation to grasp how the API works. Any missing detail forces them to guess or waste time deciphering functionality. Good documentation isn’t just about presenting data; it’s about removing friction for developers and helping them succeed.

My Advantage

• Excellent interpersonal skills
• Excellent communication skills 
• IELTS score 8
• Master of Computer Applications (MCA) and Bachelor of Science (Physics) with First Class
• More than 20 years of technical writing experience with reputed companies
• Mentored by Professional Writers and Editors
• Expertise with documentation tools such as Atlassian Confluence, SDL Trisoft, XMetal Author, Robohelp, Altova XML Spy, Adobe FrameMaker, Microsoft Word, Microsoft Visio
• Expertise in creating product documentation such as User Manuals, Installation Guides, Blogs, White Papers, Training Materials, and Standard Operating Procedures (SOP)
• Expertise in creating API documentation using Open-API Specification (Swagger), and testing APIs using Postman
• Expertise with Static Site Generators - Hugo, Jekyll
• Worked in Agile Scrum and Waterfall environment
• Expertise with version control tools such as GitHub, Tortoise Subversion, ClearCase, and Snapshot CM

Contact me

• If you have any questions or want to hire me, email me at abeeshthomas@yahoo.com.