Technical Writing Blog
1.44K subscribers
510 photos
1 file
508 links
ClickHelp โ€” online documentation tool for technical writers and teams. Create, translate, and publish documentation easily in one portal!

Get your FREE trial ๐Ÿ‘‰ https://goo.gl/NahsT2
Download Telegram
Types of Technical Documentation

The main aim of technical writing is to help users achieve their goals by using a product. Itโ€™s possible only through clear and easy-to-interpret documentation. That's why there are so many different types of technical documents. Whether youโ€™re a novice or experienced tech writer, you should know the most popular types of documentation because each of them implies different content, style and so on.

In this Ebook we will cover the following topics:

โœ…How to write effective documentation.
โœ…Good and bad technical documentation examples.
โœ…Types of technical documentation by readers and by industry.
โœ…Other popular types of technical documents like API documentation, hardware manual, software documentation, and much more.

https://is.gd/t1RlKh
Latest Tips on Using Video Content in Technical Documentation

Do you often watch How-to videos on YouTube? I am sure you do it from time to time. As for technical communication, video has already become widely spread in user manuals. Statistics show that up to 75% of users do watch video content while almost everyone neglects text.

Letโ€™s discuss in this post how to implement video to make your technical documentation clear and understandable.

https://is.gd/zNbdmo
Are you into attending online conferences in 2021? Which side are you on - online or offline format?
anonymous poll

I vote for online conferences! โ€“ 12
๐Ÿ‘๐Ÿ‘๐Ÿ‘๐Ÿ‘๐Ÿ‘๐Ÿ‘๐Ÿ‘ 40%

Makes no difference for me as long as it's free of charge โ€“ 10
๐Ÿ‘๐Ÿ‘๐Ÿ‘๐Ÿ‘๐Ÿ‘๐Ÿ‘ 33%

I'm for offline format โ€“ 7
๐Ÿ‘๐Ÿ‘๐Ÿ‘๐Ÿ‘ 23%

I'd say neither. There're all useless โ€“ 1
๐Ÿ‘ 3%

๐Ÿ‘ฅ 30 people voted so far.
Technical Writing: Readability and Text Metrics

๐Ÿค”Donโ€™t know whether your readers will understand your documentation properly? Use readability and text metrics!
๐Ÿค“They will help you measure the effectiveness of your documentation that will give you the idea of what you should improve.

๐Ÿ‘‰๐ŸปThis Ebook contains tips on how to review technical documentation right, top 5 text metrics to follow, and the like.
โœ…Much more: https://clck.ru/T2tZz
Online Conferences for Technical Writers 2021

The realities of modern life demand constant learning of new trends and tools almost in every profession. Nowadays, conferences are a part of such knowledge acquiring. So, if you want to stay relevant as a professional in tech comm, you should definitely visit some of them. Keeping in mind the unprecedented situation of 2020, many events have decided to shift to virtual.

And, here is the list of online conferences for 2021.

https://is.gd/p3hEN2
SEO and Technical Writing

Technical documentation isn't only created to convey a technical writer's ideas to an audience but it also can be used as a marketing tool.

This Ebook will help you make way to marketing opportunities since it covers a wide range of questions like:
โœ…How to use Google Analytics in technical writingโ“
โœ…How to make your content SEO-friendlyโ“

โžก๏ธโžก๏ธClick to download: https://is.gd/ZYNcDx
Using Diagrams in IT Documentation: Best Practices

In a nutshell, IT documentation is a full database of all the information an IT team needs to fulfill its tasks efficiently. Here appears the capacity to develop your business in general.

Using diagrams in IT documentation is an awesome solution to make information clear and concise. They are suitable for all kinds of users. If you know best practices in this field, you are able to create brilliant documentation, especially with the right tools at hand.

https://is.gd/0rAxrj
Techcomm Industry: Job Analysis and Forecast

โžก๏ธWant to get the job in a new technical writing sphere?
โžก๏ธLearn what industries hire!

There is a huge misconception about technical writing - people think these professionals are desired only in IT. If you want to find an interesting niche to start your career as a tech writer or you want to get the job in a new sphere, read our industry analytics report.

โžก๏ธโžก๏ธClick to download: https://is.gd/6Vj6QV
Markdown: History, Development, Aspects

This article will give you a comprehension of the markup languages, their categories, and utilization.
The Markdown language is of special interest to us here. Join the discussion.

https://is.gd/rGW7lB
Are Your Manuals Ready for Mobile World?

Nowadays people prefer smartphones to look something up because itโ€™s the quickest way to learn something.

So, are you sure your content is responsive? This Ebook will help you optimize your content according to the most popular screen resolutions.

https://is.gd/DqzHTN
How to Manage Your Technical Writing Backlog

If you are a technical writer, I am sure youโ€™ve got an endless backlog. It is sad but so true to life: so many tasks are to be done, and so little time! Letโ€™s figure out how to cope with piling up tasks to increase your companyโ€™s productivity.

https://is.gd/9mXcXI
HTML Templates for User Manuals

If you want to create and most importantly design your documentation quickly, download this free ZIP package by ClickHelp that contains 6 different documentation templates, style files, fonts, and images for all templates, and much more!

Give it a try! https://is.gd/qiVd1Z
Content Is King!... Or Queen?

Itโ€™s officially springtime! The spring is always filled with bloom, hopes for better days, and beauty. So today, we decided to talk about women in technical writing. They inspire, motivate, surprise, and compel us with their determination, creative approach, and intelligence.

https://is.gd/VLYrZq
โ„นJoin the Webinar
โ„นMarch 30, 2021

โžก๏ธThe technologies that support the Darwin Information Typing Architecture (DITA) promise numerous benefits when it comes to single-source and multi-format publishing. DITA is supposed to save us a lot of time creating, maintaining, and updating content. Those improvements come with substantial costs (significant energy and time spent implementing DITA solutions) that make creating content more difficult than it ought to be.

No single technology will suit the needs of every organization, this is true of tools that support the creation of DITA-based technical documentation.

Join us for a discussion about the online product documentation creation platform, ClickHelp. We'll take a peek at the simple-to-use ClickHelp WYSIWYG editor that supports the production of single-source dynamic content without the need to learn a complex technology. Discover why some documentation teams find ClickHelp to be more cost-effective than a traditional DITA implementation while providing the functionality required to produce exceptional product content experiences.

โžก๏ธRegister: https://bit.ly/3rmbaAu

Can't make the live event? Register and we'll send you a link you can use to watch a recording of the show.

#clickhelp #webinar
Tips to Make Instructional Videos

Do you know that 90% of users prefer instructional videos when they want to learn something? More than 50% of people watch video tutorials at least twice a week. Isnโ€™t that impressive? Surely, it is!
So, letโ€™s go on learning HOW to create video content for your tech docs!

https://is.gd/NHx0e6
10 Free Markdown Text Editors

Due to the growth of the Markdown language, every basic platform has a fair scope of Markdown editors. We have gathered editors platform-wise - for Mac, Windows, Linux, and of course, online editors. Here are some of the FREE finest editors with their unique features.

https://is.gd/qpzeh5
Standard operating procedures, or SOPs, are documents that contain a set of instructions on how to perform a task in a correct and safe way according to all the regulations. What are the best practices? Read in this post!

https://is.gd/1sXuVg
Nowadays, most people have smartphones so that they can read the QR code. Add QR codes to marketing materials, business cards, device labels, packaging and instructions for medicine, the front/back cover of manuals, and any other place where you want to.
Read this post to get more information about QR codes to make your technical documentation user-friendlyโžก๏ธ

https://is.gd/lehN6U
โ„น๏ธWe have great news for you: following our article about DITA we had the honor to participate in the โ€œClickHelp as a DITA Alternativeโ€ webinar organized by Scott Abel.
โ €
Discover why some documentation teams find ClickHelp more cost-effective than a traditional DITA implementation while providing the functionality required to produce exceptional product content experiences.
โ €
โ–ถ๏ธSee the webinar to learn what ClickHelp has to offer and to discover whether it might be a good fit for your technical documentation teams' needs.
โ €
Good luck with your technical writing!
โ–ถ๏ธhttps://is.gd/5D3GTB