Archive
Hopeful Writing: Article One: Documents Are Instruments
Most professional documents are completed before they produce an outcome. They reach a point where the writing is acceptable, the structure looks reasonable, and the document can be shared. At that point, work often stops.
The document exists. Work has not moved forward.
A professional document is an instrument. It exists to produce a specific business outcome.
Some documents move work forward quickly. Others generate discussion without resolution. The difference reflects how the document is structured and what it enables the reader to do.
What documents are for
Documents support business outcomes such as making a decision, reaching alignment, or initiating execution. Background, context, and analysis support those outcomes.
Writers often focus on describing the situation in detail. Readers focus on what the document enables.
That difference shows up during review. Questions like “What are we being asked to do?” or “Is this meant for approval?” are signals that the function of the document is unclear.
When the intended outcome is not explicit, readers infer one. Different readers infer different outcomes. Teams enter review with different assumptions about the document’s purpose.
Review slows. Alignment fragments. Decisions are delayed.
Purpose needs to be explicit, and up front
Many documents open by describing what they contain. They explain what the system does, what the initiative includes, or what problem space is being explored. That context is useful.
Readers decide how to engage early. They decide whether to skim, where to focus, and how closely to evaluate what follows. That evaluation depends on purpose.
A clear purpose statement defines the role of the document, the action expected from the reader, and the standard used to evaluate it.
When purpose appears late, readers form an initial interpretation and then revise it. That introduces re-reading, inconsistent evaluation, and delay.
Clear purpose saves time.
Focus on outcomes
Effective documents make the path to an outcome visible.
They state the decision, the recommendation, the tradeoffs, and the next steps. They identify ownership. They define what success looks like.
This allows the reader to evaluate once, with the right context.
Teams move faster when the requested action is clear, ownership is defined, and success is measurable. Disagreement centers on tradeoffs rather than interpretation.
Viewed this way, purpose serves the organization. It ensures the document contributes to the work.
Evaluating your own document
Before sharing a document, pause and ask: What outcome does this document support? What action is required from the reader? What happens after this document is read?
If those answers are not clear near the beginning, the document will struggle in review regardless of the quality of the writing elsewhere.
Addressing that gap is usually more effective than refining sentences or adding detail.
Why this comes first
Documents fail before language becomes the limiting factor.
Word choice and tone affect readability. Purpose and structure determine whether the document can be evaluated at all.
Once the document is treated as an instrument, structure and emphasis follow from the outcome it is meant to produce.
That shift changes how documents behave in practice. Work moves forward with less friction.
Hopeful Writing is about writing documents that work—the kind that lead to clear decisions, shared understanding, and effective execution. It presents practical guidance grounded in expert feedback across real business documents. The result is a systematic approach to writing that prioritizes usefulness over polish.
Introducing The Hopeful Writing Series
As an engineer, as an engineering manager, and as a former Doc Bar Raiser with Amazon, I have a well-defined perspective on what makes a quality document, the process and thinking that goes into that outcome, and a clear vision of what I want my documents to achieve.
I’m sharing that with you.
Documents have the power to shape decisions
In most organizations, written documents are the primary way decisions are made, communicated, and revisited.
They capture:
- the problem
- the options
- the reasoning
- the recommendation
- and the plan for execution
They answer:
- What decision is required
- What is being recommended
- What happens next
- What happens if no action is taken
They become the shared reference point for people who were not in the same conversation or who engage with the decision later. The quality of the document directly affects the quality of the decision. Clear structure reduces interpretation. Specific language reduces ambiguity. Evidence allows evaluation.
When these are present, decisions move forward with less friction. When they are not, the cost shows up in delay, misalignment, and rework.
What this series covers
In this series, I share my perspective on approaches that produce a quality document. We focus on how documents behave in real environments:
- how purpose determines structure
- how structure shapes interpretation
- how language expresses ownership
- how evidence supports evaluation
- how recommendation and implementation affect outcomes
- how documents are reviewed in practice
Documents influence how organizations think and act. A well-structured document allows a reader to evaluate a decision once, with the right context. A poorly structured document requires the reader to interpret intent before they can evaluate it. The difference between those states determines how quickly work moves forward.
Let’s make that difference visible and repeatable.
Hopeful Writing is about writing documents that work—the kind that lead to clear decisions, shared understanding, and effective execution. It presents practical guidance grounded in expert feedback across real business documents. The result is a systematic approach to writing that prioritizes usefulness over polish.
A Prompt Response
Today’s Prompt
Describe a random encounter with a stranger that stuck out positively to you.
I’m a fairly introverted person. I don’t often end up in conversations with strangers, would almost never speak to a stranger unless spoken to, and don’t like mingling with crowds of people I don’t know. The only time I even voluntarily end up in situations like that are either playing in front of crowds when I was a musician, or the poker room. And in both of those cases, I have a reason for doing the thing I’m doing. And luckily, neither require recreational conversation.
In March of 2017 I was a few weeks away from starting at Amazon. I’d already accepted the offer and was waiting for my official start date. I was coming off of a six month break after leaving my previous company, CoStar, and hadn’t really pursued Amazon specifically, but when the chance came to interview I prepared and was able to nail it. Regardless, I was still nervous about the idea of working for a FAANG company after 17 years of sustained success in a fairly stable, predictable environment at LoopNet and CoStar.
My uncle and I went to Las Vegas for one of our patented annual getaways. We’d spend four to five days playing poker tournaments at Caesar’s Palace. I often did well; of the 15 or so tournaments we would play I’d place quite a few times, and win a couple. The fields weren’t super deep, maybe 100 or so, and it was a good way to get away, relax, see one of my favorite people in the whole world, and play some poker.
The last night of our stay I hit a bit of bad luck and busted out of a tournament early. I wasn’t too sad; earlier that night I’d managed to win one and I felt like I was playing pretty well. So I took my tournament winnings and requested a seat at one of the $2-$5 no limit cash games.
I ended up sitting next to trio of friends at one of the tables, with a woman in her late 20s immediately to my right. To her right was one of her friends, a tall man about the same age. As I mentioned, I don’t talk much socially, not even at (or maybe especially at) a poker table, but during a slow run of cards the man asked me what I did for work. I told him I was about to start at Amazon as an engineering manager.
The woman’s eyes lit up and she told me she was a software engineer at Zappos, a company that Amazon had acquired the year before.
We spent the next hour or so chatting about engineering, software, Amazon culture, Zappos, and anything else that mattered, and in doing so, the woman slowly eased my concerns about my new role and new adventure. We may have even played a pot or two. To this day it remains one of the few social moments where I didn’t care about what I was saying or how I was being viewed or anything else that would set off my internal introvert…just two software engineers talking shop at the poker table.
Eventually, my uncle was also knocked out of the tournament, and came over to let me know it was time to head out. I turned to the woman and thanked her for the conversation and the information and the enjoyable company, before getting up to cash in my chips.
The shock on my uncle’s face was blatantly obvious, and in many ways, almost as rewarding as the reassurance provided by the hour of shop talk.
This post is one of many in my responses to random prompts surfaced by the application that tracks my website statistics, as well as any others I encounter.
