7 answers
CareerVillage Office Hours
Student
Palo Alto, California
475
Questions
Asked
728 views
How to become a technical writer?
Lend your expertise: what does it take to become a technical writer?
Note: We've seen a lot of interest in this career, so we're looking for guidance from our community of professionals.
Login to comment
7 answers
Sruthi Vedula
Sr DevOps Engineer
1
Answer
Minnesota City, Minnesota
Updated
Sruthi’s Answer
This engaging conversation has spurred me to write an in-depth article on the subject of technical writing, as I couldn't include all the details here. Here's the free link:
https://medium.com/@Sruthi-vedula/writing-for-the-digital-age-tips-for-aspiring-technical-writers-ffbaa63da5c1
In brief, my aim was to craft a relatable guid for anyone curious about venturing into the realm of technical writing. I wanted to highlight the crucial role of clear communication in our intricate world.
Covered several key points:
1. Education and Skills: While a degree in fields like English or engineering can help, the real focus should be on developing strong writing skills and becoming familiar with tools like Markdown and documentation software.
2.Getting Experience: Gain hands-on experience through internships, building a portfolio, and even volunteering to create documentation for local businesses. This experience can really set you apart when job hunting.
3. Lifelong Learning: In a field that evolves quickly, Is prudent to stay updated on industry trends and networking by joining professional organizations and attending workshops.
4. Types of Technical Writing: Eexamples like user manuals, API documentation, and process guides, along with tips on how to make these documents clear and user-friendly.
5. Best Practices: Knowing your audience, using plain language, and incorporating visuals are essential. Consistently incorporate revising your work and seeking feedback to improve clarity and usability.
6. Helpful Resources: I rounded it out with a list of educational platforms, forms, writing tools, and communities where aspiring writers can learn and connect, like Coursera, Grammarly, and TechWhirl.
Hope this helps!
I'd love to hear from you! If you have experiences or insights in technical writing please share in the comments. Did I miss any key points or tips?
Your feedback and stories are valuable, and together we can build a richer understanding of this field. Looking forward to your thoughts!
https://medium.com/@Sruthi-vedula/writing-for-the-digital-age-tips-for-aspiring-technical-writers-ffbaa63da5c1
In brief, my aim was to craft a relatable guid for anyone curious about venturing into the realm of technical writing. I wanted to highlight the crucial role of clear communication in our intricate world.
Covered several key points:
1. Education and Skills: While a degree in fields like English or engineering can help, the real focus should be on developing strong writing skills and becoming familiar with tools like Markdown and documentation software.
2.Getting Experience: Gain hands-on experience through internships, building a portfolio, and even volunteering to create documentation for local businesses. This experience can really set you apart when job hunting.
3. Lifelong Learning: In a field that evolves quickly, Is prudent to stay updated on industry trends and networking by joining professional organizations and attending workshops.
4. Types of Technical Writing: Eexamples like user manuals, API documentation, and process guides, along with tips on how to make these documents clear and user-friendly.
5. Best Practices: Knowing your audience, using plain language, and incorporating visuals are essential. Consistently incorporate revising your work and seeking feedback to improve clarity and usability.
6. Helpful Resources: I rounded it out with a list of educational platforms, forms, writing tools, and communities where aspiring writers can learn and connect, like Coursera, Grammarly, and TechWhirl.
Hope this helps!
I'd love to hear from you! If you have experiences or insights in technical writing please share in the comments. Did I miss any key points or tips?
Your feedback and stories are valuable, and together we can build a richer understanding of this field. Looking forward to your thoughts!
Tony Roig
Volunteer
45
Answers
New Hope, Pennsylvania
Updated
Tony’s Answer
I would start with reviewing reference materials provided by the government as well as the profession. These include federal (e.g. occupational outlook handbook, dictionary of occupational titles) and your state employment offices and the Society of Technical Writers.
Matthew Trull
Technical Writer
22
Answers
Thonotosassa, Florida
Updated
Matthew’s Answer
Hello,
The following is a list of ten steps you can
1. Focus on Writing Skills
Take Writing and English Classes: If you're still in school, consider enrolling in courses that develop strong writing, grammar, and communication skills.
2. Learn Technical Subjects
Study Science and Technology: Taking courses in computer science, engineering, or other STEM subjects will give you the technical knowledge that’s helpful for technical writing.
Research Technical Topics: Read articles or watch videos on technology, software, and scientific innovations. It’ll familiarize you with the type of content you might write about later.
3. Develop Research Skills
Learn to Do Effective Research: You’ll need strong research skills to understand complex topics. Start practicing by researching topics for school papers or personal projects.
4. Practice Writing Instructions
Create How-To Guides: Write guides on familiar topics, like how to use an app or assemble a gadget. This is the essence of technical writing—explaining how to do things clearly and concisely. For example, I authored a set of instructions for my mother-in-law for sending email messages from her iPhone.
5. Explore Software Tools
Learn Writing Tools: Get familiar with tools like Microsoft Word, Visio, Google Docs, and eventually specialized software like Adobe FrameMaker or MadCap Flare.
Basic Graphic Design: Learning basic design skills using software like Canva or Adobe Illustrator can help, as technical writers often include visuals in their work.
6. Consider Internships or Part-Time Jobs
Look for Student Internships: As you move through school, seek internships or volunteer work in industries that need technical writers, like IT companies, manufacturing firms, or even local businesses.
Freelance Writing: Explore platforms like Upwork or Fiverr for entry-level freelance writing gigs to start building a portfolio.
7. Pursue Higher Education
Choose a Relevant College Major: Consider degrees in Technical Writing, Communications, English, Journalism, or even a STEM field if you want to specialize in highly technical areas.
Earn a Technical Writing certification: Some colleges/universities have Technical Writing certification programs (This was my choice when I began my Tech Writing career).
Take Technical Writing Courses: Many colleges offer specific technical writing courses, and there are online courses (e.g., Coursera, Udemy) available to build skills even earlier.
8. Build a Portfolio
Create a Collection of Writing Samples: As you write more, keep a portfolio of your work, whether it’s school projects, freelance work, or personal guides. This will be essential for landing jobs later.
I'd like to express how important it is to build a portfolio. Many jobs require examples of your work before you're even considered for the position.
9. Stay Updated on Industry Trends
Read Technical Writing Blogs/Forums: Stay in the loop by following industry blogs, forums, and attending webinars. Understanding how the field is evolving will help you stay competitive. Consider joining the Society of Technical Communications (STC). There is an annual financial commitment for membership (for more information stc.org/membership/ ). The STC is one of the most well-known organizations for technical writers. With membership, you'll have access to a wide variety of benefits.
10. Network with Professionals
Attend Career Fairs and Networking Events: Even in school, networking is valuable. Attend writing conferences, technical expos, or job fairs, and connect with professionals on LinkedIn.
I hope this info is helpful.
Regards,
Matthew
The following is a list of ten steps you can
1. Focus on Writing Skills
Take Writing and English Classes: If you're still in school, consider enrolling in courses that develop strong writing, grammar, and communication skills.
2. Learn Technical Subjects
Study Science and Technology: Taking courses in computer science, engineering, or other STEM subjects will give you the technical knowledge that’s helpful for technical writing.
Research Technical Topics: Read articles or watch videos on technology, software, and scientific innovations. It’ll familiarize you with the type of content you might write about later.
3. Develop Research Skills
Learn to Do Effective Research: You’ll need strong research skills to understand complex topics. Start practicing by researching topics for school papers or personal projects.
4. Practice Writing Instructions
Create How-To Guides: Write guides on familiar topics, like how to use an app or assemble a gadget. This is the essence of technical writing—explaining how to do things clearly and concisely. For example, I authored a set of instructions for my mother-in-law for sending email messages from her iPhone.
5. Explore Software Tools
Learn Writing Tools: Get familiar with tools like Microsoft Word, Visio, Google Docs, and eventually specialized software like Adobe FrameMaker or MadCap Flare.
Basic Graphic Design: Learning basic design skills using software like Canva or Adobe Illustrator can help, as technical writers often include visuals in their work.
6. Consider Internships or Part-Time Jobs
Look for Student Internships: As you move through school, seek internships or volunteer work in industries that need technical writers, like IT companies, manufacturing firms, or even local businesses.
Freelance Writing: Explore platforms like Upwork or Fiverr for entry-level freelance writing gigs to start building a portfolio.
7. Pursue Higher Education
Choose a Relevant College Major: Consider degrees in Technical Writing, Communications, English, Journalism, or even a STEM field if you want to specialize in highly technical areas.
Earn a Technical Writing certification: Some colleges/universities have Technical Writing certification programs (This was my choice when I began my Tech Writing career).
Take Technical Writing Courses: Many colleges offer specific technical writing courses, and there are online courses (e.g., Coursera, Udemy) available to build skills even earlier.
8. Build a Portfolio
Create a Collection of Writing Samples: As you write more, keep a portfolio of your work, whether it’s school projects, freelance work, or personal guides. This will be essential for landing jobs later.
I'd like to express how important it is to build a portfolio. Many jobs require examples of your work before you're even considered for the position.
9. Stay Updated on Industry Trends
Read Technical Writing Blogs/Forums: Stay in the loop by following industry blogs, forums, and attending webinars. Understanding how the field is evolving will help you stay competitive. Consider joining the Society of Technical Communications (STC). There is an annual financial commitment for membership (for more information stc.org/membership/ ). The STC is one of the most well-known organizations for technical writers. With membership, you'll have access to a wide variety of benefits.
10. Network with Professionals
Attend Career Fairs and Networking Events: Even in school, networking is valuable. Attend writing conferences, technical expos, or job fairs, and connect with professionals on LinkedIn.
I hope this info is helpful.
Regards,
Matthew
Along with Step 5, getting versed on Adobe RoboHelp will also be useful.
S Angie Allen
Joanne Williams
Associate Professor
31
Answers
Olivet, Michigan
Updated
Joanne’s Answer
One detail I need in order to answer is: What is the subject?
Usually, technical writers have a specialty, or knowledge in a related area, i.e., science, health, or engineering.
So, where do your skills and passions find you? Become an expert, a trivia buff, and a competent voice for that specialty.
Then, know how to communicate that knowledge to the audience you will be addressing. To do this, you must also have
a deep familiarity with the English language. So, read, speak, write, practice always. This is a craft, and just like any other
the more time, passion, and talent you pump into it, the better and more satisfying the results, for you, and your reader.
By the way, you are encouraged to find your voice, and your way of styling your content, so your writing is not only accurate
and ethical, but engaging as well.
Usually, technical writers have a specialty, or knowledge in a related area, i.e., science, health, or engineering.
So, where do your skills and passions find you? Become an expert, a trivia buff, and a competent voice for that specialty.
Then, know how to communicate that knowledge to the audience you will be addressing. To do this, you must also have
a deep familiarity with the English language. So, read, speak, write, practice always. This is a craft, and just like any other
the more time, passion, and talent you pump into it, the better and more satisfying the results, for you, and your reader.
By the way, you are encouraged to find your voice, and your way of styling your content, so your writing is not only accurate
and ethical, but engaging as well.
Tami Sullivan
Content Developer
15
Answers
New York, New York
Updated
Tami’s Answer
Technical Writers typically have a rich background filled with hands-on experience and specialized education. Many colleges and universities offer robust Technical Writing programs, featuring comprehensive courses in writing, editing, technology, business computing, and even specific scientific fields. Some Technical Writers may also hold degrees in Engineering, Science, or technical subjects like Computer Programming. These training programs often include internships, providing some flexibility in selecting a specialized path. Beyond this, Technical Writers are expected to possess a superior grasp of grammar and additional skills such as digital design.
Rahul Ramakrishna
Staff Engineer
4
Answers
San Francisco, California
Updated
Rahul’s Answer
To become a technical writer, you'll need a combination of skills, education, and experience. Here's a not so comprehensive guide on how to pursue this career:
1. Educational Background:
- A bachelor's degree is typically required, often in English, Communications, Journalism, or a technical field related to the industry you want to write for (e.g., Computer Science, Engineering).
- Some universities offer specific programs or courses in technical writing.
2. Develop Key Skills:
- Strong writing and editing abilities
- Attention to detail
- Ability to explain complex concepts simply
- Research skills
- Familiarity with document design and layout
- Basic understanding of the subject matter you'll be writing about
3. Technical Knowledge:
- Learn industry-standard tools like Adobe FrameMaker, MadCap Flare, or DITA XML
- Familiarize yourself with content management systems
- Understanding of HTML, CSS, and maybe some programming languages can be beneficial
4. Build a Portfolio:
- Create sample technical documents, user manuals, or how-to guides
- Contribute to open-source documentation projects
- Offer to create documentation for local businesses or non-profits
5. Specialize:
- Choose an industry or type of documentation to focus on (e.g., software user guides, medical device manuals, API documentation)
6. Network:
- Join professional organizations like the Society for Technical Communication (STC)
- Attend industry conferences and workshops
- Participate in online forums and communities for technical writers
Hope this helps. Becoming a successful technical writer often requires a combination of writing talent, technical aptitude, and industry knowledge. It's a field where continuous learning is key, as technologies and best practices evolve.
1. Educational Background:
- A bachelor's degree is typically required, often in English, Communications, Journalism, or a technical field related to the industry you want to write for (e.g., Computer Science, Engineering).
- Some universities offer specific programs or courses in technical writing.
2. Develop Key Skills:
- Strong writing and editing abilities
- Attention to detail
- Ability to explain complex concepts simply
- Research skills
- Familiarity with document design and layout
- Basic understanding of the subject matter you'll be writing about
3. Technical Knowledge:
- Learn industry-standard tools like Adobe FrameMaker, MadCap Flare, or DITA XML
- Familiarize yourself with content management systems
- Understanding of HTML, CSS, and maybe some programming languages can be beneficial
4. Build a Portfolio:
- Create sample technical documents, user manuals, or how-to guides
- Contribute to open-source documentation projects
- Offer to create documentation for local businesses or non-profits
5. Specialize:
- Choose an industry or type of documentation to focus on (e.g., software user guides, medical device manuals, API documentation)
6. Network:
- Join professional organizations like the Society for Technical Communication (STC)
- Attend industry conferences and workshops
- Participate in online forums and communities for technical writers
Hope this helps. Becoming a successful technical writer often requires a combination of writing talent, technical aptitude, and industry knowledge. It's a field where continuous learning is key, as technologies and best practices evolve.
Dulce Montemayor
Principal Content Experience Manager
2
Answers
Redmond, Washington
Updated
Dulce’s Answer
That's the same question i had two decades and 4 years ago!
While AI serves an aggregated answer for this, I'd also incorporate what I've seen through my journey (adding them as NOTES:). Wanting to be a technical writer is different than putting on the work to become one and operationalizing and living the experience.
AI says 'Becoming a technical writer involves a combination of education, skill development, and practical experience. Here are some steps to guide you on this path:'
1. Educational Background: While a degree in technical writing isn't always necessary, having a bachelor's degree in a related field such as technical communications, scientific writing, journalism, or English can improve your job prospects (https://www.indeed.com/career-advice/career-development/how-to-become-technical-writer)
NOTE: The best technical writers that I've met in the industry graduated from various degrees (Journalism, Communication Research, Computer Science, Computer Networking, Business Administration and Accountancy, Management Information Systems, Graphics Design and Illustration, Library and Information Services).
2. Certification: Pursuing a certification in technical writing can help you stand out. There are various online courses and certifications available that can provide you with the necessary skills and knowledge (https://www.indeed.com/career-advice/career-development/technical-writing-certifications).
3. Skill Development: Focus on developing key skills such as written communication, research, and analysis. Familiarize yourself with the tools and software commonly used in technical writing for your industry (https://www.indeed.com/career-advice/career-development/how-to-become-technical-writer)
NOTE: The best way to learn is to do your research, read, and understand as much as you can, and then apply them. I invested on a couple of books too (The Chicago Manual of Style and the IBM Style Guide) so you might try that, because that investment paid off! Find internship or volunteer gigs where there's opportunities to work alongside seasoned writers, ask them if they could mentor you, and if they say yes, that's a great way to learn from them in the context of the work they do as technical writers.
4. Create a Portfolio: Build a portfolio of writing samples that showcase your ability to create clear and concise technical documents. This can include user guides, manuals, and other instructional materials
NOTE: Out of courtesy and legal obligations, when applying for technical writing jobs, you're supposed to either share either publicly available work or originals. To prep for that, while you're training (either on self-paced mode or on a paid course), collect your writing samples and exercises. Make sure they're polished though (which means they're grammatically correct, intentional/serve a purpose, they are properly formatted).
5. Networking: Connect with professionals in the industry through networking events, online forums, and social media platforms. This can help you learn about job opportunities and gain insights from experienced technical writers . Build up your professional network
NOTE: In my technical writing research journey early on, I came across STC (Society for Technical Communication), which my mentor/manager at that time also recommended that I look into. I've gone through free reading materials (because it had membership costs) and when there was an opportunity for the company I worked for at that time to sponsor membership, I took that and attended some sessions. Here's an article about STC: https://medium.com/level-up-web/70-years-of-educating-technical-writers-the-stc-story-8e019a1e2eb1
As I navigated work-life balance though and moved companies, I wasn't able to keep up on those sessions nor renewed my membership. It was replaced though with in-house technical writing sessions in the company I'm working for now and they're a tremendous source of practical guidance on how to grow further in this area. It's always good to learn on the job.
6. Continuous Learning: Stay updated with the latest trends and technologies in your field. Consider learning basic coding languages and web design to enhance your technical writing skills (Develop your industry knowledge, Take a course in technical writing, Read books and tech articles).
NOTE: Research. Read. Find mentors. Attend conferences. Learn from the best in the field. Learn from your mistakes and the mistakes of others. There's a lot to learn because technical writing is such a dynamic and fluid industry (because it requires professionals to continuously adapt and update their skills to meet the ever-changing demands of various fields). You can look at various specializations depending on your interest. It's essential to learn the basics though, to have the right set of soft skills and hard skills. Then, specialize.
7. Practical Experience: Gain practical experience by working on projects that involve technical writing. This can include internships, freelance work, or contributing to open-source projects.
NOTE: Please see my notes above on finding internship and volunteer opportunities where you can meet potential mentors, get mentored, learn from the job, aside from attending conferences, etc.
8. Start writing.
I hope it helps!
While AI serves an aggregated answer for this, I'd also incorporate what I've seen through my journey (adding them as NOTES:). Wanting to be a technical writer is different than putting on the work to become one and operationalizing and living the experience.
AI says 'Becoming a technical writer involves a combination of education, skill development, and practical experience. Here are some steps to guide you on this path:'
1. Educational Background: While a degree in technical writing isn't always necessary, having a bachelor's degree in a related field such as technical communications, scientific writing, journalism, or English can improve your job prospects (https://www.indeed.com/career-advice/career-development/how-to-become-technical-writer)
NOTE: The best technical writers that I've met in the industry graduated from various degrees (Journalism, Communication Research, Computer Science, Computer Networking, Business Administration and Accountancy, Management Information Systems, Graphics Design and Illustration, Library and Information Services).
2. Certification: Pursuing a certification in technical writing can help you stand out. There are various online courses and certifications available that can provide you with the necessary skills and knowledge (https://www.indeed.com/career-advice/career-development/technical-writing-certifications).
3. Skill Development: Focus on developing key skills such as written communication, research, and analysis. Familiarize yourself with the tools and software commonly used in technical writing for your industry (https://www.indeed.com/career-advice/career-development/how-to-become-technical-writer)
NOTE: The best way to learn is to do your research, read, and understand as much as you can, and then apply them. I invested on a couple of books too (The Chicago Manual of Style and the IBM Style Guide) so you might try that, because that investment paid off! Find internship or volunteer gigs where there's opportunities to work alongside seasoned writers, ask them if they could mentor you, and if they say yes, that's a great way to learn from them in the context of the work they do as technical writers.
4. Create a Portfolio: Build a portfolio of writing samples that showcase your ability to create clear and concise technical documents. This can include user guides, manuals, and other instructional materials
NOTE: Out of courtesy and legal obligations, when applying for technical writing jobs, you're supposed to either share either publicly available work or originals. To prep for that, while you're training (either on self-paced mode or on a paid course), collect your writing samples and exercises. Make sure they're polished though (which means they're grammatically correct, intentional/serve a purpose, they are properly formatted).
5. Networking: Connect with professionals in the industry through networking events, online forums, and social media platforms. This can help you learn about job opportunities and gain insights from experienced technical writers . Build up your professional network
NOTE: In my technical writing research journey early on, I came across STC (Society for Technical Communication), which my mentor/manager at that time also recommended that I look into. I've gone through free reading materials (because it had membership costs) and when there was an opportunity for the company I worked for at that time to sponsor membership, I took that and attended some sessions. Here's an article about STC: https://medium.com/level-up-web/70-years-of-educating-technical-writers-the-stc-story-8e019a1e2eb1
As I navigated work-life balance though and moved companies, I wasn't able to keep up on those sessions nor renewed my membership. It was replaced though with in-house technical writing sessions in the company I'm working for now and they're a tremendous source of practical guidance on how to grow further in this area. It's always good to learn on the job.
6. Continuous Learning: Stay updated with the latest trends and technologies in your field. Consider learning basic coding languages and web design to enhance your technical writing skills (Develop your industry knowledge, Take a course in technical writing, Read books and tech articles).
NOTE: Research. Read. Find mentors. Attend conferences. Learn from the best in the field. Learn from your mistakes and the mistakes of others. There's a lot to learn because technical writing is such a dynamic and fluid industry (because it requires professionals to continuously adapt and update their skills to meet the ever-changing demands of various fields). You can look at various specializations depending on your interest. It's essential to learn the basics though, to have the right set of soft skills and hard skills. Then, specialize.
7. Practical Experience: Gain practical experience by working on projects that involve technical writing. This can include internships, freelance work, or contributing to open-source projects.
NOTE: Please see my notes above on finding internship and volunteer opportunities where you can meet potential mentors, get mentored, learn from the job, aside from attending conferences, etc.
8. Start writing.
I hope it helps!