Introduction To Technical Writing: A beginner's guide
Tags: webdev, tutorial, beginners, programming
Published: 2023-06-23 18:50:34

**Are you new to Technical writing? Never written an article before? Well, it's fine! By the end of this article, it will provide you with enough materials to get you started on your technical writing journey.**

I will be sharing material courses on technical writing, where you can publish your articles and apply for jobs. I will also share how I got accepted to write for two companies. I hope all your questions will be answered by the end of this article.

## What Is Technical Writing?
Technical writing is a type of writing that communicates complex and specialized information to a specific audience clearly and concisely.

It aims to explain technical concepts, procedures, and instructions to readers who may not have a technical background, expertise, and practitioners.

Technical writing includes user manuals, instruction guides, reports, and more. It often involves breaking down complex technical information into simpler terms, using diagrams, charts, and other visual aids to help readers understand the material.

## Importance Technical Writing
Let's say the company you work for develops a new software product. The product was innovative and had the potential to revolutionize the market. However, the company didn't invest much time in documenting the technical aspects of the product.

As a result, the product was difficult to use, and customers were frustrated when they encountered problems.

Realizing their mistake, the company hired a technical writer to create comprehensive documentation for their product. The technical writer worked closely with the developers and created user manuals, online help files, and other types of documentation to assist customers.

With the new documentation in place, customers were able to use the product more easily and had fewer problems.

You can see how Technical writing played a crucial role in assisting customers in understanding the company's products. It's like when you buy an electronic gadget and you find a manual inside to help you understand how to use the product.

Technical writers are employed in many industries, such as engineering, software development, healthcare, and more.

## Technical Writing Materials

- [Google Technical Writing Courses](https://developers.google.com/tech-writing)
- [Tech: Write and Earn](https://startuptrybe.trainercentralsite.com/course/techwriteearn#/home) - (Highly recommended)
- [Technical Writing](https://www.pluralsight.com/courses/technical-writing-software-documentation) - Documentation on software products
- [Documenting APIs](https://idratherbewriting.com/learnapidoc/): A Guide for Technical Writer
- [Learn Tech Writing](https://learntechwriting.co/index.html)
- [Coding for writers](https://www.udemy.com/course/coding-for-writers-1-basic-programming/) - Basic programming
- [Professional Technical Writing](https://www.udemy.com/course/technical-writing-and-editing/): Advance writing skills

## Books For Technical Writers
- [The Developer's Guide to Content Creation](https://www.developersguidetocontent.com/)
- [Technical Writing 101](https://www.amazon.com/Technical-Writing-101-Real-World-Planning/dp/0970473362)
- [Technical Writing Essentials](https://www.amazon.com/Elements-Technical-Writing-3rd/dp/0205583814)

## Where To Get Technical Writing Gigs
Several companies pay writers to write for them. Most times, these companies require you to send a proposal. If your proposal is accepted, you get to write on the topic you proposed and get paid. These companies have been compiled in a GitHub repository for easy access.

I will be dropping different GitHub links, some might contain the same companies but with the addition of

- [Malgamves Community Writer Program](https://github.com/malgamves/CommunityWriterPrograms) - This contains a list of companies that hire Technical writers.
- [Getting Started With Technical Writing](https://github.com/Bennykillua/Getting-started-in-Technical-Writing) - This is a list of technical writing material with companies included where you can apply for technical writing jobs.
- [Who pays Technical writers](https://whopaystechnicalwriters.com/?) - A list of Technical writing agencies and the amount they pay.

## Technical Writing Tools
I will be dropping tools you can make use of to make your technical writing journey easier.

- [Technical-writing-template](https://github.com/BolajiAyodeji/technical-writing-template) - A sample template with guidelines for writing technical articles.
- [HackMD](https://hackmd.io/) - You can collaborate on technical documentation in markdown. It provides you with great writing tools so you get to see the code you document alongside your writing.
- [Canva](https://www.canva.com/) - Create cover images for your articles and blog posts.
- [Annotely](https://annotely.com/) - Make drawings, highlights, blurs, and screenshots
- [Mermaid](https://mermaid.js.org/#/README) - Create diagrams and visualizations using text and code.
- [Notion](https://www.notion.so/) - I personally make use of notion to write out my blogging ideas. The all-in-one workspace for your notes, tasks, wikis, and databases.
- [Grammarly](https://app.grammarly.com/) - Grammarly is a writing assistant that goes deeper than grammar to offer you comprehensive writing feedback.
- [README Markdown generator](https://github.com/kefranabg/readme-md-generator) - CLI that generates beautiful README.md files.

## Technical Writing Guide
When deciding how to create content, it is important to pay attention to some companies that already have amazing style guides to guide you. Here is a list of them:

- [Microsoft style guide](https://learn.microsoft.com/en-us/style-guide/welcome/) - Microsoft manual style guide.
- [Google style guide](https://developers.google.com/style) - provides editorial guidelines for writing clear and consistent Google-related developer documentation.
- [Diataxis](https://diataxis.fr/) - A systematic framework for technical documentation authoring
- [GitLab](https://docs.gitlab.com/ee/development/documentation/styleguide/)
- [IBM style guide](http://ptgmedia.pearsoncmg.com/images/9780132101301/samplepages/0132101300.pdf) - IBM editorial style guide.
- [Freecodecamp style guide](https://www.freecodecamp.org/news/developer-news-style-guide/) - Their publication style guide.

## Build Your Portfolio
One of the fastest ways of getting a response from a company you mailed for a job application is by showing them samples of your work. The two companies I work with got back to me with job offers because I showed them samples of my work - articles.

Having a blog where you post your writing will give you a high advantage and connect you to potential recruiters. Below is the list of platforms where you can post your articles.

- [Hashnode](https://hashnode.com/) - A community for developers and technical writers.
- [Dev](https://dev.to/) - A platform for writers and developers
- [Medium ](https://medium.com/)- A platform for writers

**NOTE: You can also get paid on these platforms though they have rules and requirements.**

Another important thing you should note is that the article you intend to show to any company matters! Don't send an article on JavaScript when the company only deals with the topic of AI. Also ensure, you present your best articles.

When you write, ensure your work is clean, understandable, and readable. That is another trait companies look out for.

Let me know if you have any questions in the comment section and if you found this article useful, please like, follow, and share with your friends.