How do you write a blog?

My name is Ito and I am an infrastructure engineer.
In order to open our company's technology blog,
the most important thing is, of course, ``write a blog .

However, since we have never attempted something like this before,
I think some people may think that writing a blog is difficult.

So, as someone who regularly runs a blog, I thought I should write a summary of how to write a blog, and
I would like to take the opportunity to summarize this as an article!

So, the first Beyond Technology blog will be for internal use, but it's about how to write a blog!

Write information instead of diary

This is natural since it's a technology blog, but
when I think about what a blog is, I come to the conclusion that it's about providing information.

For example, no one is asking for things like, ``I ate omelet rice yesterday.''
If it were a celebrity's daily life, that alone would be a good story. .

You probably end up on a technical blog like this when you're having some trouble.
That's why I think it should have ``written things that can help you solve problems.''

So...if you're going to write an article about ``I ate omelet rice yesterday,'
' how about an article about ``I ate omelet rice at a Western restaurant called ○○,'' which is currently a hot topic?

In this case, the subject changes from "boku" to "shop."
So, even if I reveal who I am, it won't solve anything, but
if someone wants to know about the store, I think they can find out what kind of store it is and that will lead to a solution.

This could be considered information.

I want this blog to be able to help people who are in trouble.

Consider ease of viewing

When writing, it's good to write information, but
what if it's difficult to understand?

For example, write one line without line breaks.
Summarize the previous sentence into one line.

This is natural since it's a technology blog, but when I think about what a blog is, I come to the conclusion that it's about providing information. For example, no one is asking for things like, ``I ate omelet rice yesterday.'' If it were a celebrity's daily life, that alone would be a good story. . You probably end up on a technical blog like this when you're having some trouble. That's why I think it should have ``written things that can help you solve problems.''

What do you think? It's hard to see, isn't it? . I can't feel like reading! !
Appropriate line breaks are very important.

Ease of viewing is partly visual, but there is another factor.

It means "easy to understand."
Since this is a technical blog, there will be a lot of technical terms, but it is important to write about them in an easy-to-understand manner.

• Why did this happen?
• What led you to this conclusion?

If you don't write this clearly, the engineers won't be able to understand it...

Do you like the flow of your writing?

1. I've had a problem
2. So how can I solve it?
3. Why do we do that?

The rest is detailed technique

such as adding proper headings, using images in the middle, and not leaving the URL in Japanese, but
I will omit those details

summary

As you can see, it is important to write a summary!

Especially if it's a long text, you may not understand what information it contains when you read it to the end.
So, it would be helpful to write a brief summary at the end!

These two things are important when writing a blog.

• provide information
• Pursuing clarity

I think it would be a good idea to use these two as the basics and then flesh them out (detailed techniques).
I would like to post a lot of information like this!