Technical Writing ToolBox

A Blog on Technical Writing

Tag Archives: Technical writing

Thank You for 200,000 views!

Dear Viewer, Thank you!

What else can I ever say to express my humble gratitude to all the viewers of my personal technical writing blog (TechnicalWritingToolBox.com) who viewed my humble words over 200,000 times?

Almost a decade ago, I was working as a Technical Writer in New Delhi, India in the hi-tech IT/Semiconductor industry. The position was very challenging, and it paid damm well, making it a pretty cool job.

However, I wanted to grow and develop myself, and one fine day I finally decided to get uncomfortable, left that comfy job for a year-long study sabbatical (Technical Communication Course @ Seneca College, Toronto), and came to Canada as an International student and that was the beginning of a tough yet interesting journey.

Leaving all of my friends, my family, the familiar sights and smells of Indian Bazaar, and a promising career was not easy. It was the single most difficult and perhaps the most important decision of my life.

I researched Universities in Canada, USA, UK, Australia and finalized Canada as a destination because of the great culture (weather was better in Australia, USA had more job opportunities) and least racism compared to other countries.

I graduated with honors and started working as a technical writer. Then the exciting world of DevOps caught my interest and I transitioned myself into a DevOps Engineer. Read my personal DevOps blog at DevOpsBlog.ca.

When I was debating myself whether to leave my job and all the comforts of my job to start again as a student in a foreign land, one little-faint voice kept me awake at nights which always asked “What if you don’t go and regret the decision after 10 years?”.

It has been 10 years and I am glad that I made that tough decision and I will encourage you to have faith and listen to that little-faint voice in your heart which begs you to get uncomfortable today to be very comfortable tomorrow!

Advertisement

Technical Writing: The 24th Best Job in 2015

technical_writing_2015

Careercast released the 2015 list of top 200 different jobs in the U.S. The ranking is based on four critical aspects that are inherent to every job: environment, income, employment outlook (Growth, Income Growth, and Unemployment), and stress. The data for this report came from the Bureau of Labor Statistics and other government agencies in U.S.

Read more >>

STC Webinar Recording- Higher Education in Technical Communication

I recently conducted a webinar on Higher Education in Technical Communication for STC India Management SIG. You can view the Youtube video recording of the session on this blog post.

I would love to hear your feedback regarding this session. Is it exciting? Is it boring? Would you like to attend my next webinar? Please leave a comment and let me know.

Webinar – Higher Education in Technical Communication

I am conducting a webinar titled “Higher Education in Technical Communication”  for STC India Management SIG. Please register if you are interested in learning more about higher education opportunities in technical writing.

Registration link: http://www.stc-india.org/events/webinar-jan-31-2015-higher-education-in-technical-communication/

higher education

Difference between Literary Writing and Technical Writing

Adaptability and Flexibility for Technical Writers

A stretching lion at Ouwehands Dierenpark.

Adaptability and Flexibility skills are now becoming a necessity, and not just a desired quality, to get hired as a technical writer.

Employers want to hire highly adaptable and flexible technical writers who can learn latest technologies, new documentation tools, and can find their way in the maze of social media.
Read more >>

Technical Writer Salaries- How much do Technical Writers earn?

Without money

Without money (Photo credit: Toban Black)

In our society, money is the most important reason for which people work. Of course, other factors such as learning and gaining a sense of accomplishment after doing their work are also a major driving factor for many. However, most of us will never work for free (at-least not full-time) since we all need to pay the bills. Compensation is often a closely guarded secret and we seldom talk about this important subject.

When I came to Canada, I tried to research over the salaries in the Toronto region and was surprised to see a wide range of reported salaries for technical writers in Canada (but none for the Toronto region). The best and honest advice about technical writing salaries in my area came not from the Internet but from the network I made with fellow technical writers in the GTA (Greater Toronto Area).

In this blog post I will try to share that knowledge for the benefit of others and will try to compare technical writer salaries in the U.S., Canada, and India.
Read more >>

Enrolling for a Technical Writing Course?

A depiction of the world’s oldest continually operating university, the University of Bologna, Italy.- Image Credit, Wikipedia

Learning on the job is a great thing. But, is getting a higher education in Technical Writing after gaining some real-world experience a good choice as well?

I worked as a technical writer for eight years in New Delhi. Recently, I took a sabbatical to pursue a post-graduate certificate in technical communication from Seneca College, Toronto. The term sabbatical (from Latin ‘sabbaticus’, from Greek ‘sabbatikos’, from Hebrew shabbat, that is Sabbath, literally means “ceasing”) means – to take a break from work for an extended period of time, to pursue a goal.

Looking back at the golden triangle of cost, time, and scope, my decision to pursue higher education in technical writing after getting the real-world experience, was challenging and satisfying at the same time. I often felt that the learning outside the classroom is more important than studying in the classroom. For example, walking a kilometer to my class in -25 degrees, and under a heavy snowfall was as challenging as writing a technical autobiography for my technical writing class.

Read more >>

Higher Education in Technical Communication- Is it worth it?

Technical Communicators are passionate about learning and often ponder on the question of higher education in the field of technical communication. The dream of gaining knowledge and credibility by pursuing higher education in technical writing often eludes technical writers at all levels of their career.

Gurpreet’s First Day @Seneca College

I worked as a technical writer for eight years in New Delhi and recently took a sabbatical to pursue a postgraduate certificate in technical communication from Seneca College, Toronto. The term sabbatical (from Latin ‘sabbaticus’, from Greek ‘sabbatikos’, from Hebrew shabbat, i.e., Sabbath, literally a “ceasing”) means to take a break from work for an extended period of time to pursue a goal. In modern times, several professionals have started taking a sabbatical to pursue higher education in their chosen disciplines.

Read more >>

How to write a Technical Autobiography?

Technical Autobiography of Nikola Tesla

When I joined Seneca College (Post Grad) Certificate in Technical Communication, the first (informal) writing assignment we received was to write a technical autobiography (worth 10%) in the TCN700 (Technical Writing I) class.

Wait, I hear you saying that the term ‘technical’ and ‘autobiography’ don’t go well together. You are in good company as most of us in the class at that moment thought on similar lines. It was only when our dear professor explained the concept of technical autobiography when we understood how important it is for a writing student.

Read more >>

10 Useful LinkedIn Groups for Technical Writers

LinkedIn started out in the living room of its co-founder Reid Hoffman in 2002 and now operates the world’s largest professional network on the Internet with 161 million members in over 200 countries and territories. It is available in seventeen languages: English, Czech, Dutch, French, German, Indonesian, Italian, Japanese, Korean, Malay, Polish, Portuguese, Romanian, Russian, Spanish, Swedish and Turkish.

LinkedIn receives a new member after every half second. If you do not exist on LinkedIn then you are surely missing job and consulting opportunities available in this professional network. If you are present on LinkedIn, I invite you to get connected with me at http://ca.linkedin.com/in/gurpreettw.

Read more >>

My talk on Technical Writing in George Brown College, Toronto

George Brown College (St. James campus at King Street) in Toronto

I was invited to give a talk on Technical Writing at George Brown College, Toronto few weeks ago. I talked about technical writing in general and how social media tools such as twitter, blogs, and LinkedIn can help them in getting a writing related  job or consulting assignments.

It was a lovely experience for me as I love to talk about technical writing and social media. I hope that my talk inspired few of them to use social media tools to demonstrate and publicise their writing portfolios and they will soon receive their desired writing assignments through this new tool in their arsenal.

Read more >>

Technical Writing: The 37th Best Job in 2012

I always dreamed of becoming an astronomer- to see what no man has seen before. However my interest in learning and building complex systems encouraged me to become an Engineer and my love toward writing made technical writing a viable and exciting choice for my work. Which profession, other than technical communication, allows a person to use both his/her technical and writing skills at work?

Read more >>

Brand Damage due to Bad Translation

Canada Government Immigration department ad in Hindi language having 5 typos (out of 18 words)

Canada Government Immigration department advertisement in Hindi language (Indian language) having 5 typos (out of 18 words)

I love studying in Canada. It’s a land of opportunity.

People in my class, College, and even strangers walking on roads of Canada are helpful (except for few weirdos I often encounter) and even Canadian Government supports many programs that help immigrants to adjust in the Canadian society.

Read more >>

The Controversial discussion about Outsourcing and Technical Writing

An auto rickshaw (aka a three-wheeler taxi) showing an ad of a call center training institute in the South Indian town of Madurai. Photo Credit : http://anticap.wordpress.com

Indian technical writing industry is often blamed for taking  technical writing jobs away from North American markets. In various mailing lists, this issue raises its ugly head from time to time, starting a heated debate about the threat of outsourcing to non-English speaking countries such as India. Tom Johnson, in his article about technical writing jobs, considers outsourcing (of technical writing jobs to India) as a threat to the technical writing industry in North America.

Read more >>

The Love-Hate relationship between Technical Writers and Software Tools

 

FrameMaker, MS Word, PowerPoint, Excel, Quark Express, Visio, SnagIT, RoboHelp, Madcap Flare, Author IT, Acrobat, PageMaker, Wiki, XMetal, Oxygen… more and yet more tools.

Read more >>

A day in a Technical Writer’s life

Good Morning!

My name is Gurpreet Singh and I’m a student of technical communication. I’m pursuing a yearlong post graduate certificate in technical communication from Seneca College, Toronto. Before joining this program, I worked as a technical writer for eight long years in New Delhi, India.

A lot of people in my class asked me to explain how it feels to work as a technical writer. They wanted to know if technical writing is exciting or does it becomes boring after spending few years down the line.

The interesting thing about technical writing is that technical writers enjoy a multitude of roles and responsibilities, which includes delivering documentation for a plethora of products while meeting stricter deadlines. Thus, no two work-days are alike. Each new day starts with a fresh set of challenges. These challenges make the day and the life of a technical communicator all the more exciting.

I work used to work as a Technical writer in the hi-tech Semiconductor domain, and develop documentation for a wide array of commercial EDA (Electronic Design Automation) software.  Technical writers in my organization are referred to as Learning Product Engineers (LP Engineers). Here is a snapshot of my day when I was working as a technical writer:

My day usually starts with a morning scrum meeting. Each meeting usually lasts for 15 minutes. During the meeting, each team member reports about what they accomplished on the previous day, issues or major showstopper, and the plan for the day of the meeting. These meetings are also called as stand-up meetings, because the goal of these meetings is to keep them brief and productive. Hence, all members attend these meetings standing instead of sitting.

Every Monday, we have a longer weekly meeting with our manager to discuss the status of projects, issues, challenges, and so on. Team meetings also provide a forum to discuss team-specific internal documents. For example, the Style Guide. Discussions about purchasing new tools also take place during these meetings.

Monday also happens to be the planning day when we set plans for the week including meetings with subject matter experts (SMEs) (blocking time in their MS Outlook calendar is essential!), training calendar for self, and scheduling meetings related to various internal and external projects.

Rest of the week is usually a good mix of long write-edit review cycles, meetings, and training.

A typical day in my work life looks somewhat like this:

  • Check corporate emails with a cup of hot Cappuccino: I receive most of the emails from my R&D team based in Santa Clara, California. Due to the time zone difference, they are 12 hours behind us (my night is their day). So, while I’m having a sound sleep, my colleagues continue to develop new features during their day, and send me various documentation requests.
  • Listen to voicemails: Few of the SMEs I work with hate writing long emails. Hence, they leave voicemails for me, which may include information about a new feature. Works great!
  • Attend documentation meeting: As a mentor, I attend documentation meetings to troubleshoot any issues faced by junior writers, or to redirect them to a specific group/person.
  • Moderate Wiki pages: We use Confluence Wiki to author, review, collaborate, and publish technical documentation. A nightly build generates chm, html, and pdfs, directly using the content from Wiki. The beauty of this system is that SMEs (R&D, QA, Sales, Marketing, and Management) can directly edit and add content, instead of routing every request to a LP Engineer. I edit the updated or the newly added Wiki pages for grammatical mistakes, accuracy, and adherence to our internal writing style sheet.
  • Install new software build: Every morning a fresh software build is made available in the repository. After installing, I usually play around with the application to check if there are new enhancements/fixes that are displayed in the GUI. Though, I often get documentation requests in form of emails or bugs logged in Bugzilla, it is not uncommon to detect a new setting popping in the new build.
  • Close documentation bugs/New Feature documentation: Every day I run a query in Bugzilla to check new documentation bugs/requests filed for me (New feature documentation requests are also filed as bugs). Some bugs need 5 minutes of effort while others (majority) may require an effort of couple of hours. Occasionally, I have bugs (enhancement requests) that might take a few weeks to get completed. Zero bug report is what my eyes dream of seeing everyday.
  • Lunch: Home cooked food with a few friends in the office cafeteria: A major stress buster for my day!
  • Research using internal/external networks: My work involves documenting extremely technical products for an audience that comprises Engineers and Scientists (who prefer no-nonsense technical documentation). Thus, I try to learn as much as I can about a new feature before I write about it.
  • Check the Doc Project Schedule: Since I work on multiple projects, I keep a tab on all the deadlines (daily/weekly) and try to make sure that everything runs smoothly. In case of a slippage in the schedule, I schedule a meeting with the project manager to mitigate any impact by lowering the scope, or by requesting a fresh deadline.
  • Conduct Trainings: I often get requests from various teams/groups within my organization to conduct training on Wiki, writing, presentation skills, and Lean/Six-Sigma topics.
  • Conduct Lean Meetings: As a Lean/Six-Sigma champion for my team, I lead few internal projects to reduce technical writing process timelines, reduce documentation defects, and improve productivity, and to find areas of automation with our technical writing tools or processes.
  • Coffee Break: Catching up with an old friend with a hot cup of coffee is nothing less than having an apartment in the heavens!
  • Conduct Toastmasters Sessions: Being the president of our Corporate Toast-masters Club, I often conduct the toastmasters session that help our club members (from various departments and placed at different levels in the hierarchy) to develop their presentation, public speaking, and leadership skills. I’m an award winning humorous speaker!
  • Conduct Peer Review: Every documentation project in my team has an author and a peer reviewer. The peer reviewer acts as a dummy user and tries to validate documentation for usability and functional errors, which are often unnoticed by the author. I review two projects in my team. Similarly, my own projects get reviewed by two different authors. I always get amazed by the fact that how easily others can catch errors in our work, which we fail to see, even after several cycles of internal testing.
  • Say Sayonara to work and head back to home-sweet-home!

Wait: Meeting with the Santa Clara R&D team is at 11.30 pm, and it extends well past midnight: Another disadvantage of the global work environment. But hey, it is still fun to be a technical writer working with global teams!

What do you think about my workday? Is it similar to yours? Leave a comment and let me know 🙂

%d bloggers like this: