by Bradley Nice, Content Manager at ClickHelp — all-in-one help authoring tool

Oh wow, did I have a great vacation! But all things come to an end, and others begin, so I’m here with some great news that I almost missed out being away surfing: the Rainbow release from ClickHelp is here. It is as multifaceted as this beautiful natural phenomenon. There are lots of improvements and new features, like a new dashboard, translation editor, reader UI localization, topic editor updates, and more. You can read about them in this blog post. …


by Bradley Nice, Content Manager at ClickHelp — all-in-one help authoring tool

The other day I had the “pleasure” to communicate with a chatbot for quizzes. That wasn’t very good. Several times we hit the conversation dead-end. It made me wonder who writes the content for such chatbots and how to make it more efficient and user-friendly. I already wrote about chatbots in technical communication. This time we’ll discuss the content for chatbots.

Bots are a relatively new user interface made to help humans. It’s another type of help desk when you can’t complete a task. Technical writers play a…


by Bradley Nice, Content Manager at ClickHelp — all-in-one help authoring tool

One might think that technical documentation emerged only after the industrial revolution when most technical devices came into existence. But if we look deeper, we see that the drawing is considered one of the earliest process documentation. Or, rather, its varieties that have come down from antiquity. First people used the walls of the caves, the stones to carve the drawings, and even the earth. The birth of construction drawings dates back to when people built a dwelling or storage room for utensils or livestock to survive winters…


by Bradley Nice, Content Manager at ClickHelp — all-in-one help authoring tool

Document formatting is the appearance and visual structure of a document. It’s the mechanics of how the words appear on the page. A well-formatted document should be:

  • consistent,
  • correct,
  • meet stated requirements,
  • be reader-friendly.

The visual appeal affects the readers and how they perceive the information, so formatting is essential for any document. …


by Bradley Nice, Content Manager at ClickHelp — all-in-one help authoring tool

Don’t be fooled with the title “writers.” Technical writers frequently present their work using visuals. Cause there are different learning styles they apply and the fact that a picture is worth a thousand words. Information is communicated more easily with visuals.

Visuals help to present complex information (like technical processes) in portions. Abstract concepts also become more definite with a relevant graph or another type of technical illustration.

Product Illustration

Technical drawings are a crucial element of your content, especially when you’rу writing the documents for a company that sells…


by Bradley Nice, Content Manager at ClickHelp — all-in-one help authoring tool

People react to and handle visual information better than any other type of information. Indeed, the human brain processes image 60,000 times faster than text, and 90 percent of the data transmitted to the brain is visual. It’ is a worthy reason to use this skill to enhance data processing.

Visual content is more entertaining and easy to look at than just plain old text. Reading in order to learn is good, but learning and at the same time being entertained visually is better. Visual representations get your…


by Bradley Nice, Content Manager at ClickHelp — all-in-one help authoring tool

“The person who made a mistake and didn’t correct it made another mistake.”

Confucius

The main goal of any product or company is to reach the customer effectively. This can be done with professional technical documentation, and every company has many technical documents.

Let’s talk about transforming boring technical texts into a reliable and valuable resource to improve the company’s image by avoiding common writing mistakes.

Technical Documentation Pains and Ways to Cure Them

  1. Outdated documentation. Documentation becomes obsolete way too quickly without a plan for updating. Remember this when you make your documentation, and apply…


by Bradley Nice, Content Manager at ClickHelp — all-in-one help authoring tool

Time is perhaps one of your most limited and valuable resources. There are many things in life we can make more of, buy more of, or repeat if we don’t get it right the first time. Time is not one of those commodities. Everybody understands that, but there is a vast list of time-wasters that impede our ability to spend time profitably. Among the obvious are, for example, social networks, video games, and uncontrolled series watching.

However, there is a time-waster that is not obvious — overly long…


by Bradley Nice, Content Manager at ClickHelp — all-in-one help authoring tool

Robots are often described as some kind of intruders in literature or movies, and games. And most of the time, it never ends well (try Terminator — so many sequels and humanity still losing). But if you think about that, we already in an era of robots, not the ones that look exactly like humans, but smartphones, voice-activated assistants, smart gadgets for your home, cars with auto-driving, and even homes. So many things are automated now. And it is for the best, of course, especially when we are…


by Bradley Nice, Content Manager at ClickHelp — all-in-one help authoring tool

Nowadays, competition between companies has gone far beyond capacity output competition and a technology race. Progress has led companies to the fact that the same products are made in various areas; such products differ in minor details. So how do manufacturers win the hearts of buyers? Branding is the answer! It is crucial not only to offer quality goods or services but also to offer them contrasted with the crowd of competitors.

Most people who start their business or are already working in a particular area of ​​small…

Bradley Nice

Content Manager at https://medium.com/level-up-web 👈. I write about web design, web development and technical writing. Follow me on Twitter and Facebook

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store