: Re: 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

@Speyer920

Vote Up Vote Down

It depends on how formal the context is. If you're writing a short blog post about getting started with a new game, "you'll" probably won't be out of place. If you're writing a tutorial as part of the documentation set for expensive enterprise software, it's more common in my experience to avoid contractions.

If your company or publisher has a style guide, follow it. If they don't or you're self-publishing, decide how formal you want to be: "you'll" is more folksy and "you will" is more formal (but not stuffy).

One tangential note: I try to avoid making promises about what the reader will learn; who knows if my reader will actually get it? I talk about what we will show, not what you will learn.

(0)

Login to post a comment!