This post is mainly to answer the most frequently asked question when I get a call from aspiring technical writers• • • • • •
How to become a technical writer? How to get into Technical Writing Industry? How do you get into Technical Writing? Trying to transition to Technical Writing, what do recruiters look for? Technical Writing Tips What is Technical Writing?
If you are a writer and dream to become a technical writer and work with the world most important technologies companies like Google, Microsoft, Adobe, Amazon, Thales, then this blog post is for you. If you are a writing nerd like me, you must have heard about this profession. But, if you’re part of the other 99.9% of the world who isn’t super excited about this profession,” you’ve probably missed this news. Technical writers are the second most paid writing professionals first is, of course, ransom writers. Growth projection is 20% in India and 11% in U.S.A (from the Bureau of Labor Statistics). The prominence of technical writing in the IT sector can be known through this article too. Read it here [caption id="attachment_2660" align="aligncenter" width="700"]
Technical writing in NEWS[/caption]
As a single writer, you can build a career as a full-time technical writer from the comfort of your home after work, during your afternoons, and on your weekends. I don’t think that I'm overly dramatic when I say that technical writing is your shot at the life of your dreams. Trust me — I would know. Till now I have shaped up the careers of many writers through our course and many other initiatives. I want you to have as much fun at work as these guys, and I do. So, today I’ll introduce you to this world with my technical writing guide. Note: Even if you’re already knee deep, you can still learn a ton of new things. If you’re interested in a particular topic, feel free to jump ahead: 1. 2. 3. 4. 5. 6. 7. 8. 9. 10.
Overview Definition What do technical writers do? Who can become a technical writer? Where can technical communicators be placed? What are the important skills to be a successful technical writer? Resume of Technical writers What would be the average salary of technical writers? What is the career path of technical writers? How to start as a technical writer?
Overview A perfect blend of language and technology is technical writing, wherein technology is made easy for people to understand through creating user manuals, online help, and documented for future references and proper functioning of the software. In short, it is the information development process.
Definition of Technical writer If you’ve read my blog posts on technical writing, you already know that it’s different from other writing. Not every technology writing is automatically technical writing. Few definitions of technical writing are: 1. According to Wikipedia “Technical writing is any written form of writing or drafting technical communication used in a variety of technical and occupational fields, such as computer hardware
and software, engineering, chemistry, aeronautics, robotics, finance, medical, consumer electronics, and biotechnology. It encompasses the largest sub-field within technical communication”. 2. According to US Bureau of Labor Statistics “Putting technical information into easily understandable language is technical writing”. 3. Technical writing is simplifying the complex. Before taking up a career in technical writing we should know the whole scenario of technical writing as a career, and this blog post will help you in it by discussing all the major questions that whirl the mind before focusing on the definite track. Want the drop-dead simple version of it? Technical writing is an effort of simplifying the complexity of the product to help users to use it effectively. Technical writers can take help of words, images, infographics, GIFs, videos to do so. It’s anything that you do to delight and helps your customer to use a product.Customer can be internal or external.
History of Technical writing The history of technical communication goes back to the period of Aristotle around 322 BC. His works were considered as the juvenile form of technical writing, however, the first published English technical writing document was of Geoffrey Chaucer in the 14th century. With the advent of the Industrial Revolution, a period from 1760 to 1840 the need of technical writing increased. This need was a result of requirements generated for skilled resources which could handle the machinery. It became necessary to illustrate the workers how to use the machine in a simple language that can be understood by non-technical resources too. Documentation became mandatory because it was becoming a napoleon task to teach each worker verbally about the functioning of heavy machines. The need for technical writers volcanized even more during the first world war and second world war. The heavy weapons were to be used by soldiers not the technicians, so it became important to provide them the manuals to use it in the war field. Most crucial fields like medicine, aerospace technology, military, computer technology saw advancement in that period and it accelerated the need for technical writers to explain and document the processes. This led to gain technical writers professional acclaim, and it emerged as an official job titleTECHNICAL WRITER.
The postwar period was also not less rewarding. Writers were needed across different fields to register the processes as there was a rapid growth in the transport system, universities, libraries etc. The computer was losing its privilege of remaining in the hands of specialist only. Universities and large businesses were keen to make use of it for optimum results. First computation technical document was the instruction manual of BINAC computer written by Joseph D Chapline in 1949. Opportunities for technical writer increased even more when in 1947 transistor was invented. This invention led to the expansion of the computer in the small businesses and in individual hands. Computer becoming more common generated a pool of opportunity for technical writers as they were needed to explain the use of devices and to keep a written record of it. In the 1980s, consumer electronic products entered the household and gave another kick to the requirement of technical writers. In the present era, the computer has become the toy of every other hand. Digital communication has made things a lot easier than before. The writing format is also changing accordingly. Hypertext, XML, graphics and many software tools are used by technical writers for the documentation purpose. The techniques have improved and it's getting better day by day.
Technical writers in IndiaThough India has over 10,000 technical writers there was no association until 2017, to let them come under one roof for a better learning, networking, and knowledge sharing for mutual benefit. Few societies of other countries, however, worked in India. In 2017, Information developers Foundation was formed- first not for profit Indian society for technical communicators. IDF has a sole motto to expand and strengthen the technical communicator community in the best possible way covering all the basic need of technical writers ie. from training to placement and from network expansion to show your presence.
What Technical writers do? Technical writers are the person who develops the information provided in a simplified language to make it easily understandable to the people they are intended to. A technical language is difficult to understand by a common man. Technical writers convert them to make it easy for commoners to follow the instructions.
Technical writers are the optimized amalgamation of technology and English (language) to convert the complex into simple for the benefit of producer and the user both. Contrary to popular belief, technical writers donâ€™t just write user guides or manuals, but also contribute to the development lifecycle of the product. To understand the complete cycle of work read about Documentation development lifecycle. Technical writers write user manuals, online help, white papers, APIs Doc, etc. They do the documentation for a product or services for the internal user to end user of the product. Techwriters use tools to develop the information provided in a simpler language such as RoboHelp, Framemaker, MadcapFlare, SnagIT, etc.
Qualifications required to become a Technical Writer? This can vary from geographies to a hiring company. Typically any graduate with a flair for writing and technology can pursue technical writing. Good English is mandatory (or the language in which you will be communicating). For a more explanatory view, a list of eligibility criteria is given below. Few companies give preference to B.Tech/BCA/MCA/BE students. - Recently-graduated students with a Bachelorâ€™s degree in Arts, Science, Technology or Commerce. - MBA graduates can especially benefit. - Working people who need to switch their careers because of no career growth in their present job. A majority of this category belongs to the - BPO sector - Medical - Transcription industry - Journalism - Technical Support - Software Developers - Software Quality specialists. - Individuals who have stopped working for some time for family and relocation reasons and now wish to get back to a professional life (has proven very beneficial for mothers who have given up their careers to start a family) - Self-motivated individuals who believe in sharpening and updating their skills for their professional growth. - (We have even had entrepreneurs take up this program and hugely benefit their organizations.) Information Developers Foundation Students Job Profiles and Qualification
Delegate's with different jobs and qualifications join Information Developers for the better prospects and bright professional future. [caption id="" align="aligncenter" width="596"]
Information Developers Students profile[/caption]
You can see that students from different careers and domains are joining technical writing.
Where Can Technical writers get placed? Technical writing is crucial for every industry that needs documentation. As perceived it is not limited to the IT industry only. The industries that hire technical writers are
• • • • • •
IT industry Manufacturing sector Aerospace Defense sector Service industry Customer support etc.
Some of the companies Hiring Technical writers From the partial list of companies hiring Information Developers student, you will get a clear idea about companies hiring technical writing. In general product, companies hire more technical writers than service companies. • • • • • • • • • • • •
Oracle Microsoft Adobe Google Amazon Caterpillar JCB HCL SAP NOKIA HP DELL
Resume of Technical writers The first and most important thing about the technical writer or any writer resume should be error-free.All type of error like spelling, grammar, formatting, consistency, etc. Do not copy and paste and the section of the resume and do not try to fake it. Few companies consider your resume and cover letter as a sample of your work. • • • • •
The CV should be easy-to-read, well laid out, and not over-crowded. It should be customized for the job you are applying to. You should highlight the relevant skills you have for the job. It should be a concise document with no grammar or spelling mistakes. It should not be exaggerated and read honestly.
For more detail, you can read both blog post about resume. 10 Kick ass Resume writing tricks for technical writers FREELANCE TECHNICAL WRITER RESUME
What is the average salary of a Technical Writer? According to a survey done by Economic Times in 2017 Technical writing is among the emerging high payout jobs in India. Check survey here The average salary also fluctuates according to the city and country you are working. Typically starting salary of Information Developers students are from INR 3-5 lac/annum. In the U.S.A according to Labour of Beaureu static average hourly rate is approx $36/hour and mean annual wage is $74,445. You can read more on the website. You can also refer to the Indeed website. Every year STC-India conducts a salary survey. You can download the detail from STC-India website.
What is the career path of a technical writer? In the IT organizations, the career path of a technical writer is similar to other development team members. • • • • • • • •
Intern technical writer Associate technical writer Technical writer Senior technical writer Lead technical writer/Principal technical writer Documentation manager Senior Doc manager Director
Similar titles for technical writers Like any other profession, in the IT company title and designation can vary. • • • • • • • • • • •
Technical Communicator Technical Author Technical Content writer Content Developer Information Developer Information Architect Information Engineer Information Designer Documentation Specialist Documentation Manager Career growth for technical writers
A technical writer starts off as a technical writer, become a senior or principal technical writer and after having an experience of around 10 years they move towards the management side. They can be the scrum master, Documentation manager, or content strategist too. They normally manage other technical writers and analyze their writings and suggest better ways from their experiences. The highest paying advanced career path is of content strategist though the requirements are very few in the industry they are the creamy layer if calculated on the scale of earnings.
A week in the life of a Technical Writer My week typically look like this. • • • • • • • • • •
I start my day by updating JIRA. Attend daily scrum. Write new features and maintain existing documentation.· Work closely with developers, product architects, and product owners to create technical documentation with a high focus on clarity, completeness, accuracy, and usability. Obtain product information from agile meetings, specifications, supplemental material, and discussions with project engineers. Participate in peer review processes to improve documentation quality. Contribute to develop and maintain existing documentation processes, standards, checklists, and templates. Suggest screen labels and error messages with a focus on improving the customer experience (UX). Create graphics to supplement the flow and presentation of the content. Help in translation and localization processes.
You can watch the video of Amruta Randa to take a feel of typical technical writer day.
Typical Job description for technical writing General Information Job title: Consultant - Senior/Staff Technical Writer Job Family: Development Region: Global Role: Mid -Senior Level (L2) Number of Positions: 1 Position Summary
A mid-level position, responsible for providing front-end technical support to customers and proactively enabling customer self-service. Job Overview For reference, I have taken this example from LinkedIn. As a Technical Writer at XYZ, you will be responsible to support XYZ Global development team by working on software documentation for system administrators and users. XYZxcels in developing product related to Backup and Storage domain and the suitable Writer needs to have a good understanding of terminology and process required to understand database and back-end work in software development. Work Experience • Experience for Senior Staff Technical Writer: 5-9 years • Experience for Staff Technical Writer: 2-5 years
Location: Noida Mandatory Skills: 1. Good technical understanding of SDLC and DDLC. 2. Minimum 6 months experience in using MadCap Flare tool for documentation. 3. Excellent knowledge and experience of authoring in HTML and XML editing tools. Description of General Work: • Working independently as well as part of a large distributed team. • Handling one or multiple products/projects depending upon the requirement. • Research, and write documentation for new or existing products. • Work closely in Agile project development with development, product management, quality assurance, user experience/design, training, and support personnel. •
Good in Information gathering skill. To know more about this skill watch my video about Information gathering.
Preferred Skills • University degree or Technical Writing college diploma in relevant field.
• Excellent oral and written communication skills. • Knowledge of how to create and use graphics in technical documentation. • Knowledge of MS-Visio. • Knowledge of authoring tools, such as Framemaker or RoboHelp • Experience with bug tracking tools, such as JIRA. • Ability to write and design minimalist information. • Experience of working in an agile development process.
Best books to learn Technical writing Any day Microsoft Manual of Style (MSTP) is a mother of all the technical writing books. Microsoft Manual of Style and The Chicago Manual of Style is a must for you. Get MSTP now. Just click on the image and get it now I repeat if you are serious about your career.
Few more good books you can read. Thank you to Amruta Ranade (Cockroach lab, U.S.A) and Gyanesh Talwar (Adobe) for giving a valuable recommendation on our Facebook group.
How to start as a full-time technical writer? By now you must have a fair idea about technical writing and it is time to take action. 1. Read the job description carefully. 2. Do gap analysis also you can go for SWOT analysis to understand what you have and what you need to learn. 3. Start learning. Google is your best friend start slowly and be focused. 4. You can attend local meetups, attend webinars and watch Information Developers recorded webinars. 5. Join the online forum on Facebook. IDF Facebook group is 1000 member strong and growing every day. Post your query. 6. Update your resume. 7. Prepare a sample work. 8. Contribute in open source documentation like GitHub. To know more, you can watch this video.
9. Start applying for an interview. Hopefully, you will get an interview call. If you crack the interview world is yours. 10. God forbid if you are not able to clear your interview to find a mentor (You can consider me). :-) 11. You can also join course designed by me with the support of other super senior professional. For more detail, about our course, you can visit the course page or call me directly on my personal number 7840841999 now.
I provide this training live online, so geography location is not an issue. Only one thing I need is a learning attitude. After training, you can apply for the job of a technical writer and can become one with a good starting salary. This worked for all it will work for you also, only focus and hard work are required.
This post is mainly to answer the most frequently asked question when I get a call from aspiring technical writers on my website https://www...
Published on Aug 10, 2018
This post is mainly to answer the most frequently asked question when I get a call from aspiring technical writers on my website https://www...