Don’t say ‘it will take five minutes’

It’s commonplace to emphasize that your product will let users achieve their goal in next to no time:

“Follow one of our quickstart guides to get started in minutes.” - Firebase quickstart

“Be up & running with Pusher in 3 minutes” - Pusher tutorials

“Learn how to build an Android Chat App in 10 minutes” - Pusher tutorials

“Deploy a serverless microservice With Lambda, API Gateway in ~2 minutes” - AWS console

There are two possible reactions to this:

• The optimist. “Just five minutes!”, he thinks, “let’s do it!” One hour later, when he is still installing Gradle, he now thinks: “Five minutes?! I must be a fool. I give up 😭”
• The realist. “Surely it can’t take five minutes. I can’t believe a word this says. 😒”

Other guides are more honest:

“You can go through the whole tutorial in a couple of hours or you may want to spend a pleasant day really digging into it.” - AngularJS tutorial

“25 min read” - Nix by Example post on Medium

I believe this approach is more successful. Consider our characters again:

• The optimist. “Two hours? I bet I can do it in an hour.” Two hours later, he thinks: “Well ... okay, it did say it would take two hours.”
• The realist. “Two hours seems reasonable. I’ll block out the time for it.”

What causes the unrealistic push to lower time estimates?

• A belief that this will draw people in. However, the people you draw in are impatient and unrealistic. They are unlikely to be real customers.
• A failure to see the complexity of what is described. The vendor has internalized the complexity of the system he sells.

Tagged #technical-writing, #communication, #product-management, #psychology, #estimates.

👋 I'm Jim, a full-stack product engineer. Want to build an amazing product and a profitable business? Read more about me or Get in touch!

Similar posts

Don’t use the word ‘simply’

Avoid using the word “simply” as it can come across as insulting to the reader by implying the task is easy or the reader is stupid. Instead, rephrase to be more objective and avoid comparatives like “simply” or “just.” 2017-02-22

Documentation black holes: things we write that don’t get read

Documentation often ends up in black holes - internal documents, issue trackers, test cases, conversations, commit messages, and wikis - where it goes unread. Focus on writing documentation that people will actually read, like product names, homepages, and inline help. 2014-08-13

Don’t use the word ‘it’

Avoid using ambiguous pronouns like “it” in technical writing. Refer to specific referents explicitly to improve clarity. 2016-11-25

The price model shapes the product

2014-10-06

Estimates are not deadlines

The difference between estimates and deadlines, and why conflating the two can cause problems in project management. 2014-07-27

The Thatcher effect in typography

2010-02-10

Similar posts

Don’t use the word ‘simply’

Avoid using the word “simply” as it can come across as insulting to the reader by implying the task is easy or the reader is stupid. Instead, rephrase to be more objective and avoid comparatives like “simply” or “just.” 2017-02-22

Documentation black holes: things we write that don’t get read

Documentation often ends up in black holes - internal documents, issue trackers, test cases, conversations, commit messages, and wikis - where it goes unread. Focus on writing documentation that people will actually read, like product names, homepages, and inline help. 2014-08-13

Don’t use the word ‘it’

Avoid using ambiguous pronouns like “it” in technical writing. Refer to specific referents explicitly to improve clarity. 2016-11-25

Estimates are not deadlines

The difference between estimates and deadlines, and why conflating the two can cause problems in project management. 2014-07-27

The price model shapes the product

2014-10-06

The Thatcher effect in typography

2010-02-10

More by Jim

What does the dot do in JavaScript?

foo.bar, foo.bar(), or foo.bar = baz - what do they mean? A deep dive into prototypical inheritance and getters/setters. 2020-11-01

Smear phishing: a new Android vulnerability

Trick Android to display an SMS as coming from any contact. Convincing phishing vuln, but still unpatched. 2020-08-06

A probabilistic pub quiz for nerds

A “true or false” quiz where you respond with your confidence level, and the optimal strategy is to report your true belief. 2020-04-26

Time is running out to catch COVID-19

Simulation shows it’s rational to deliberately infect yourself with COVID-19 early on to get treatment, but after healthcare capacity is exceeded, it’s better to avoid infection. Includes interactive parameters and visualizations. 2020-03-14

The inception bar: a new phishing method

A new phishing technique that displays a fake URL bar in Chrome for mobile. A key innovation is the “scroll jail” that traps the user in a fake browser. 2019-04-27

The hacker hype cycle

I got started with simple web development, but because enamored with increasingly esoteric programming concepts, leading to a “trough of hipster technologies” before returning to more productive work. 2019-03-23

Project C-43: the lost origins of asymmetric crypto

Bob invents asymmetric cryptography by playing loud white noise to obscure Alice’s message, which he can cancel out but an eavesdropper cannot. This idea, published in 1944 by Walter Koenig Jr., is the forgotten origin of asymmetric crypto. 2019-02-16

How Hacker News stays interesting

Hacker News buried my post on conspiracy theories in my family due to overheated discussion, not censorship. Moderation keeps the site focused on interesting technical content. 2019-01-26

My parents are Flat-Earthers

For decades, my parents have been working up to Flat-Earther beliefs. From Egyptology to Jehovah’s Witnesses to theories that human built the Moon billions of years in the future. Surprisingly, it doesn’t affect their successful lives very much. For me, it’s a fun family pastime. 2019-01-20

The dots do matter: how to scam a Gmail user

Gmail’s “dots don’t matter” feature lets scammers create an account on, say, Netflix, with your email address but different dots. Results in convincing phishing emails. 2018-04-07

The sorry state of OpenSSL usability

OpenSSL’s inadequate documentation, confusing key formats, and deprecated interfaces make it difficult to use, despite its importance. 2017-12-02

I hate telephones

I hate telephones. Some rational reasons: lack of authentication, no spam filtering, forced synchronous communication. But also just a visceral fear. 2017-11-08

The Three Ts of Time, Thought and Typing: measuring cost on the web

Businesses often tout “free” services, but the real costs come in terms of time, thought, and typing required from users. Reducing these “Three Ts” is key to improving sign-up flows and increasing conversions. 2017-10-26

Granddad died today

Granddad died. The unspoken practice of death-by-dehydration in the NHS. The Liverpool Care Pathway. Assisted dying in the UK. The importance of planning in end-of-life care. 2017-05-19

How do I call a program in C, setting up standard pipes?

A C function to create a new process, set up its standard input/output/error pipes, and return a struct containing the process ID and pipe file descriptors. 2017-02-17

Your syntax highlighter is wrong

Syntax highlighters make value judgments about code. Most highlighters judge that comments are cruft, and try to hide them. Most diff viewers judge that code deletions are bad. 2014-05-11

This page copyright James Fisher 2017. Content is not associated with my employer. Found an error? Edit this page.

Jim Fisher

CV

Speaking

Blogroll

RSS

TigYog

Kickabout