Yesterday I attended a technical writing event hosted by I4G Unilag Chapter where speakers shared more about how one can get started or improve on their technical writing skill and I thought I could share it here as it could be of help to one or two who might be reading through this article.

The first guest was Joel Adewole who is a Fulstsack developer(Python and Javascript) at Tunga and a technical who covered everything technical writing

Understanding Nitty-gritty of Technical Writing

Technical writing is the process of creating and managing written content about a particular subject that requires guidance, instruction, explanation, or analysis for readers to relate or interact well with the subject. One doesn't have to be a coder, data scientist, designer, or given tech specialist in order to be a technical writer.

Types of technical writing

A technical writer can focus on writing either:

• software/end-user documentation
• QA solutions
• how-to-guide and tutorials
• business proposals
• project requirement documents
• research papers & reports
• white papers
• product recall
• resumes

Why Technical writing

Essentials of Technical Writing On can focus on technical writing for:

• providing content for others to fall back to in future
• providing various opinions on certain subjects
• essentially making information circulate
• companies that need it to promote their products
• business to show analysis to stakeholders

benefits of technical writing

For audience They can benefit from content that:

• gives a how-to-guide that provides clear directives on how to use the subject for example tutorials on how to deploy on Heroku.
• serves as a point of reference to the subject

For writers Technical writers benefit from technical writing as helps them:-

• improve research skills i.e while writing articles one might have content but they'll still have to still research additional information and link relevant information that might benefit the target audience.
• master better communication i.e as a technical writer most often you'll but conscious of potential readers, tenses of speech, or even Grammarly
• create a professional presentation i.e most technical writers can share their work on their social profiles or even add to resume or portfolio
• creates connections i.e as you grow as a technical writer you get to connect with other technical writers, your readers who might leave a comment or relate to your content, or potential clients who might want to work with you because of your skill

demystify & overcome difficulties of technical writing

Is technical writing actually difficult? No, writing something up it’s a skill. Write particular language and skills that match with what you know. Here are some things that make people scared of getting started with technical writing and ways they can overcome it while writing:

• grammar: use grammar tools eg Grammarly, Hemingway
• plagiarism: use plagiarism checkers
• insufficient information: do research on the subject
• misinformation: test content well
• audience boredom: write engagement content
• low engagement: improve SEO

Start your path toward becoming a master technical writer

const learnToWrite = () => {
    read()
    write()
    get_feedback_from_people()
    return LearnToWrite()
}

Prerequisites of becoming technical write

• good communication skill
• understand the subject you write about
• ability to research & learn new concepts

Start your technical writing journey

• join technical writing communities
• read a variety of technical writing write-ups
• signup to public blogs e.g hashnode, dev.to, medium
• create a personal bog(optional)
• make use of professional writing tools
• explore different writing styles e.g markdown
• pitch to paid writing blogs

Protips for technical writing

• start with an outline
• discover your writing styles & stick to it...markdown, rich-text, memes, etc
• make use of infographics/visual aids e.g tables, graphs, charts
• use interactive quote snippets e.g codesandbox, codepen, jsfiddle, Github, Gists, markdown
• include reference links
• use grammar tools Grammarly, Hemingway to correct your grammar
• use SEO tools to optimize your content to better search engine ranking like Yoast

The second speaker was Olamide Makinde: content & technical writer, SheCodeAfrica lead who had an AMA session. Before getting into technical writing she had experience writing non-tech content then started writing various concepts for SheCodeAfrica and volunteering before pitching for paid writing opportunities.

• mostly she wanted things to be perfect but wasn't sure when she wanted to write in public how will people would react if it wasn't good. In the long run, she has learned to write in public to get feedback and build her skills
• being a good writer: volunteer writing has been helpful together with consistency. Unlike developers and designers, technical writers are viewed as "small" in the space but meeting other people in technical writing communities has been encouraging to her.
• rejection emails: while pitching in technical writing paid to blog, or guest writing she got a lot of rejections even when talking with other writers they had experienced the same but they didn't stop trying. Just keep applying and waiting for feedback or time they’ll accept you.
• write: there’s no rush or limit in writing
• having an accountability partner rather than mentor to keep you accountable or help read your content if they're in the same field as you.
• the fear that many people have written this topic before shouldn't stop you from writing on the said topic.
• why write the article: people know this concept, save time, know your worth/target audience

Paid Technical Writing Opportunities

If you have mastered the technical writing skills you can pitch on these various sites:

• Compiled list of paid articles sites
• Get paid to write for this 45+ sites
• Publications that pay to write technical articles
• a thread of technical writing that pays between $200 to $600

Thank you for reading this article I hope it will help you with a few hints of how to improve your technical writing skills. You can leave a comment or suggestion in the comment section. We can connect more on Twitter or LinkedIn.