How to write a good tutorial

Favourite 29 favourites
Tutorial written by TomOriginally published on 5th, July 2011 - 4 revisions

In this tutorial, I am going to walk you through writing your first tutorial, and then offer some advice on what makes a good tutorial!

So you have an idea?

The first thing you need when wanting to write a tutorial is having an idea. The idea should be something you know about, and feel you can confidently offer good advice about.

The topics that work best are specific. For example, a tutorial on "How to use all the features in Construct 2" is obviously far too broad, but a tutorial on say "The basics of using the image editor" would be a great tutorial to write. It's a niche you have picked and can write about in detail.

It's also worth checking that there is not already an exact duplicate of the tutorial you want to write. If you find an exact duplicate it will serve everyone a lot better if you offer suggestions for improvement to the original author, or if you have enough rep you can make edits to other tutorials! Remember, tutorials are community articles, and as such are meant to be gradually improved and kept up to date naturally by the community.

Got an idea? Good, let's get going!

Organising your ideas

Organising your ideas can be a great way to start. Maybe ask yourself the questions:

- What do I want to teach people about?
- What are the main things I want to write about?
- What is the best order I can write about these things?
- Are there any good analogies or ways of describing it that make it seem really simple?

It's good to have focus, a specific thing you want to teach people about, presented in a clear and ordered fashion.

Getting Started

To write a tutorial, click on the submit tutorial link at the top of the tutorials page:


You will then need to fill out the basic parts of the form:

Title

The title is pretty self explanatory, although it is worth making sure it is well chosen. Does it directly address the purpose of the tutorial in a straightforward way? The title is a great starting point for giving your tutorial focus. Keep referring back to it - have you strayed too far?

Body

This is the bread and butter of your tutorial!


The editor should be reasonably self explanatory. Click each of the icons at the top to see what they do, or refer below:


There are some keyboard shortcuts as well, try Ctrl+B for bold, Ctrl+I for italic, etc. If you want to turn some text into a link, select it and then press the hyperlink button.

Use the tags H1 and H2 to to add sub-sections to you tutorial. They will appear on the navigation menu to the left.

The new tag insert pagebreak can be used to separate your tutorial into pages.

Description

On some search pages, the description is displayed alongside the title to give more details about what your tutorial is about, for example:


Go into more detail than the title. Make it descriptive and relevant. You don't need to use it as a tool to entice people, use it to simply describe in more detail what your tutorial is about.

Tags

Tags are words that describe the tutorial. These are useful for people searching for tutorials, and help describe it in additional ways. All tutorials must have the Tutorial tag, then add some other tags! For example, this tutorial I am going to have the following tags:


When entering a tag, type it in and press space to finish it. If your tag is two words, then join them with a hyphen, for example "Graphics-Cards".

If you want to create new tags, go ahead! Just type them in. Everything will automatically index itself around your newly created tags, and we have tools that allow us to merge and edit tags to help keep things organised.

You can have a maximum of five tags. We don't want too many, otherwise tags start to become less useful.

Spelling and Grammar

We understand that a lot of people are not native speakers of English. This is fine, we still want you to submit tutorials! If your spelling and grammar isn't perfect, don't be put off. As long as you make an effort to write it to the best of your ability with good quality content, that is what matters. We are more than happy to edit tutorials to correct these sorts of errors.

Don't worry!

Seriously, don't worry about writing tutorials. If you want to write one, write one! We want to create a friendly creative and helpful community. If you have any questions about writing a tutorial, shoot any of the admins a private message and we will be happy to offer advice. Or perhaps ask people in the tutorials forum if they would like to have a tutorial about an idea you have?

Stuck for ideas?

If you have an idea, or want to write a tutorial but are stuck for ideas, check out the forum thread for tutorial requests.

Unlock your full gamedev potential

Upgrade to the Personal Edition of Construct 2, it has way more features and won't holding back from making money and using your full creativity like the free edition does. It's a one off payment and all Construct 2 editor updates are free for life!

View deals

Plus, it's got a lot of additional features that will help you save time and make more impressive games!

Congratulations on finishing this tutorial!

Did you learn a lot from it? Share it now with your friends!

Share and Copy this Tutorial

You are free to copy, distribute, transmit and adapt this work with correct attribution. Click for more info.

Comments

1
ludodesign 30.1k rep

I wanna post tutorials, but I need learning a little bit yet. Good tutorial, will help people to help others =)

Thursday, July 07, 2011 at 11:00:34 PM
0
Tom 53.4k rep

Thanks SocialLie! Look forward to reading some of your in the future.

Saturday, July 09, 2011 at 3:13:04 PM
0
shinkan 34.6k rep

After writing a tutorial is it possible to modify it later to add more things?

Saturday, July 09, 2011 at 3:42:33 PM
0
Tom 53.4k rep

Shinkan, yes it is. Theoretically it's a community tutorial, anyone with enough rep can edit it, add new bits to it etc.

Sunday, July 10, 2011 at 12:09:50 PM
1
shinkan 34.6k rep

That's perfect! Thanks Tom.

Sunday, July 10, 2011 at 1:46:25 PM
2
Phillyredsox 3,057 rep

I heard you like tutorials in your tutorials...

Loved it though. I think it will help a lot with creating useful tutorials to help boost game making productivity.

Friday, March 16, 2012 at 4:18:15 AM
0
Quique 5,817 rep

I have an idea for a Tutorial, but i don't know enough of Create 2 good practices and techniques, and i'm afraid to create something stupid or really bad. So here I go please don´t judge me hard, i´m learning......

Thursday, May 17, 2012 at 2:42:40 AM
0
stemkoski 19.6k rep

@Tom (or anybody else who knows)... is it possible to make bullet-style lists (or numbered lists) in a tutorial, or create tables?

Thursday, May 24, 2012 at 4:34:22 PM
1
Tom 53.4k rep

@Quique don't be shy! Go ahead!

@stem not at the moment but soon

Thursday, May 24, 2012 at 5:33:17 PM
0
stemkoski 19.6k rep

@Tom -- I have a question about creating a second tutorial -- when I click on "Submit a Tutorial", it brings up the text of the tutorial I previously wrote. I don't want to accidentally "overwrite" my previous work... should I just clear the textboxes and re-use them or is there a special method required to start an additional tutorial?

Tuesday, May 29, 2012 at 5:46:40 PM
0
Quique 5,817 rep

Comment by Tom

<span style="background:yellow;font-weight:bold;">@Quique</span> don't be shy! Go ahead!
@stem not at the moment but soon
Hey @Tom I already posted a tutorial, its about Parallax, please check it out and tell me what do you think!!!!
Greetings...

Friday, June 01, 2012 at 12:28:06 AM
0
Tom 53.4k rep

@stem yes that's just to save your previous work, if it's published already don't worry about it, but if it's a work in progress make sure you save it first before overwriting it!

Friday, June 01, 2012 at 12:46:03 AM
0
seac 3,701 rep

I am writing a 9slice plugin tutorial. I also want to submit my 9slice plugin for review and maybe inclusion into the next C2 version. Even if it doesn't make the cut I would love if the C2 team reviewed it and shot hot lead into it where ever it has weak points. I am getting the hang of the code but still learning so feel free to comment, I am very thick skinned. Oh, where is it you say? I am still cleaning it, I did some code upgrades and what to include those in the turorial, also I noticed some typos. Shame prevents me from uploading it at this moment, but I will upload in the next few days. Please PM me or comment here. C2 you are loved.

Saturday, June 23, 2012 at 1:34:53 PM
0
Rhindon 14.6k rep

There were a few mentions of "if you have enough rep". But there was no mention of what that mark is. How much rep do we need before we can publish a tutorial?

Thank ya! :)

Thursday, January 17, 2013 at 5:17:45 AM
0
7Soul 15.2k rep

I made a couple of changes to the tutorial, I hope it's ok.
I updated the first image to show the new site layout, and added information about the tags H1, H2 e pagebreak.

One other thing, are the parts about description and tags still relevant? I didn't want to delete a chunk of the tutorial ^^ Better leave that to Tom

Thursday, May 09, 2013 at 6:56:11 AM

Leave a comment

Everyone is welcome to leave their thoughts! Register a new account or login.