Skip to main content

Questions tagged [tutorial]

The language and communication style used in instructional videos, How-To manuals, and beginners' lessons that provide practical information about a specific subject. A tutorial often shows the fewest actions required to complete a task.

Filter by
Sorted by
Tagged with
0 votes
1 answer

Writing about a large Application Programming Interface

I would like to write a tutorial for a large Application Programming Interface, let me call that way. It is a library of many elements, in the thousand range. Obviously, only part of it is frequently ...
Gergely's user avatar
  • 161
1 vote
2 answers

During a video tutorial, when asking questions to viewers, should I use the pronoun "I" or "you"?

I am making a tutorial video on a programming language. During the video I want to ask questions to the audience. My confusion is between 2 words: "I" or "you". Let's see few ...
Pirzada's user avatar
  • 111
13 votes
6 answers

Injecting creativity into a cookbook

I'm a chef. I'm also a writer. It's inevitable that I would want to write a cookbook. In fact I've probably started a dozen that I just never got around to finishing. Partly because I'm not sure how ...
Summer's user avatar
  • 4,461
3 votes
4 answers

Is it ok to temporarily break immersion in a tutorial for a game?

At the start of a game, you sometimes have some character explaining things to you, the player, instead of the character, telling them to press A to do this and that. Paper Mario I think even makes a ...
user avatar
31 votes
5 answers

How to construct a technical tutorial when the user can't verify the results after each step?

In a technical tutorial it is helpful for a user to be able to check their progress often. Veryfing that the steps have produced a result is good because the user: has a feeling of progress can check ...
user avatar
4 votes
3 answers

First person plural for charisma?

I've been writing a friendly tutorial series for a small art software community. Somehow I decided to write it in first person plural, so the entire tutorial is "First, let's do this..." and "Now we ...
wetcircuit's user avatar
  • 27.2k
6 votes
3 answers

Should I use contractions in a technical tutorial?

In a technical tutorial which fits better: In this tutorial you'll learn or In this tutorial you will learn or in general does it make no difference?
learnAndImprove's user avatar
3 votes
3 answers

Multiple tasks and a step by step tutorial

To my knowledge step-by-step tutorials should have the form of a ladder, where you describe how to get to a place step by step– accomplishing a single task at the end. Is it possible to accomplish ...
Noah's user avatar
  • 203
4 votes
3 answers

What is the word for the action of selecting an item by a mouse?

I am writing a tutorial on how to use a specific web application and I don't know which verbs to use. Shall I use "click" for buttons? But what if the user doesn't use a mouse? Contrary to "normal" ...
Konrad Höffner's user avatar
-1 votes
1 answer

Is a 'tutorial format' acceptable for personal notes? [closed]

I am a software developer, as I get older, I find myself with the issue of not having as much time to learn as I once did. My learning schedule has gone from 'whenever I have time' to 2 hours or so a ...
deanvmc's user avatar
  • 101