Upgrade to Pro — share decks privately, control downloads, hide ads and more …

You Can Write Devastatingly Effective Docs - Barbara Minto and the Pyramid Principle

Andrew Hao
October 26, 2022

You Can Write Devastatingly Effective Docs - Barbara Minto and the Pyramid Principle

Uh-oh, you wrote another meandering doc where your reviewers lost the plot. Maybe you just sent out a long-winded email announcement that was met with more confusion. Or your tech spec is met with that famous question: "what are we solving here again?"

What if there was a way to focus your ideas and communicate them clearly and concisely? Barbara Minto did just that in 1985 in her seminal book, The Pyramid Principle and its now-famous SCQA framework. How might we learn from her so that we can be effective written communicators in a remote work world?

Join us as we help a beleaguered tech lead edit their team's product spec by learning about the key components of the SCQA framework. We'll learn how to deliver the core ideas first, build logical, deductive arguments, and win approval and achieve alignment along the way. You'll leave with a clear understanding of how to uplevel your technical communication with leadership and your colleagues!

Andrew Hao

October 26, 2022


  1. We are excited to announce that our team plans to

    move to cloud-based SaaS services. However, we need to control our costs in order to remain profitable. We plan to use a mix of private and public clouds to host our applications. We will use Google Cloud at first to host our Pizza Browsing endpoints, but because of the high cost variances we expect to need to also leverage Azure and AWS for other services. We will use a hybrid approach to migrate our applications. We will use containerization to move our applications to the cloud, and we will use scripts to automate the ⁉ What is going on here? 2
  2. 5

  3. S C Q A Our annual attrition rate is usually

    X% In this tight job market, it has gone up to Y% What can we do to retain key talent? We believe we should… ✏ You try it 14
  4. ✏ You try it Assemble task force to evaluate fully-remote

    work Move from annual to semi-annual promo cycles Overhaul our talent philosophy The Answer Recalibrate salaries with latest market data The Key Points … … … … … … … … … The Data 16
  5. S C Q A Normally our product is reliable We

    have suffered several major outages recently How can we restore product reliability? We believe we should… 18
  6. ✏ You try it Review operational metrics regularly in meetings

    Create slack by reducing team load Revamp the on-call process The Answer Decompose shared rotation into multiple rotations The Key Points … … … … … … … … … The Data 19
  7. S C Q A We have been focusing on top-line

    user growth by measuring Daily Active Users (DAU) We are unable to retain these new users, who leave our platform after an average of Y months How can we have a more holistic measurement of business performance? We believe we should… 20
  8. ✏ You try it It measures the right things for

    customer retention It measures the right things for everything else Change our north star metric from DAU to XYZ The Answer It measures the right things for customer acquisition The Key Points … … … … … … … … … The Data 21