The “Beginning Auto Layout Tutorial in iOS 7” on the popular iOS development site Ray Wenderlich starts with this paragraph:

Have you ever been frustrated trying to make your apps look good in both portrait and landscape orientation? Is making screen layouts that support both the iPhone and iPad driving you to the brink of madness? Despair no longer, I bring you good news!

And it made an immediate impact when I first read it.

I have some experience coding for iOS 6, but I didn’t really work with Auto Layout; instead I did everything in code. Doesn’t matter. What I’m trying to say is that I had some familiarity with the general topic, but not with this specific feature.

And then I read that paragraph and the questions there gave me an a-ha moment instantly.

“Ah, so that’s what Auto Layout is for!”

“So these are the benefits!”

“It’s important to learn it, then!”

Using the form of questions, the author (Matthijs Hollemans) managed to teach and persuade in a subtle, yet effective, way. If he’d written a normal sentence (“Auto Layout is used to make your app behave correctly on portrait and landscape orientation”), it would sound pretty boring, with little to no impact to my learning. But by adding the frustration and brink of madness keywords, not only he managed to convey the purpose of the feature,  he also subtly showed me why it could be a better alternative compared to whatever it was I am using (hardcoding, in my case).

It’s an interesting writing technique. I like it.