General guidelines for creating great tutorials:

The tone of your tutorial should be friendly. Try to make the reader feel that they’re building and learning something together with you.

All tutorials should have the same tone, regardless of the topic.

Keep it simple and on topic as people who want to learn multiple subjects will take multiple tutorials.

Produce a tangible result. The topic is demonstrated with a small practical project and not only a theoretical “hello world” example. The tutorial reader will come out of it with a working example on their environment.

Be short. An estimated 60 minutes for a tutorial is an absolute maximum. Most tutorials should be in the range of 5 - 15 minutes.

Be divided in short steps. Each step is practical and results in user-visible progress.

Make intentional mistakes. Learning by error is a key way of learning new things!

Be entertaining! Try to have a fun project to work on, even if it’s something impractical!

Login to Color.io Hub