How to Write Better Beginner Tutorials

Every day people search the internet on how to do something, and there are many tutorials to answer their questions. Due to some issues with the tutorial itself, they may not always find the actual answers they need. Maybe they are not clear, or it is too complicated.

Over the years, I have personally read and written many tutorials, articles and tutorials for beginners on various topics. I have found ways to improve my teaching methods, and I hope to share with you guys.

Just focus on what you have to say

Imagine you are talking to someone. Whether they are driverless or driverless has reached the point. If they say a lot of unnecessary things and repeat themselves often, you may only be listening to half of them or even turn off the phone. When people read your tutorial, they look for answers to questions and don’t want to read a lot of things that they think are pointless.

Therefore, when editing the tutorial, focus only on what to say and cut out what isn’t actually helpful.

Avoid an overload of information.

Who really read the fine print or the terms of those seemingly super-sized novels, but written by people who love to show off because of a lot of long stories? If people receive too many messages at once, they will be automatically closed. I personally find it difficult to memorize too many instructions at once. I was hoping you could give me some instructions. My memory started to disappear after the first four.
It’s best to put your information in smaller paragraphs and focus on one thing at a time. If you have a lot to say, consider splitting the tutorial into IE: Part 1, Part 2, etc.

So put yourself in the minds of beginners. If you want to learn something, how would you like to present the information to you? Use bold headings to explain the meaning of the following paragraphs or sections, and avoid using unfamiliar terms that beginners may not currently understand.

Don’t patronize your readers.

This may seem obvious, but you should always pay attention to it. A few years ago I sent someone a programming question in a magazine, and the first part of the answer he printed was, “Even if the example is clear in the manual, I’ll give you another example.” I found this very offensive. It may be clear to him, but it isn’t for me, because I wouldn’t write to him first.

Some people think that if someone doesn’t know them, that person will be fat and should be patronized. If someone doesn’t understand what is being explained to them, some people will be angry. It is important to remember that people have different learning speeds and skills. If you find yourself as a person with a bad attitude towards people, this can be reflected in your work.

Therefore, you should focus on helping the person understand rather than attacking them because you think what they are saying is obvious or stupid. Some people are indeed stupid, but they don’t have to do it on purpose. If they don’t understand something, assure them that you are not threatening them and that you are trying to help them.

and last but not least

Understanding people’s needs and being patient can help you become a better tutor. Listen to their opinions and learn from them to improve your writing skills.

Leave a Reply

Your email address will not be published.