Skip to content

Frequently Asked Questions

Sections are real reader questions in their natural phrasing, ordered by likelihood of being asked rather than by logical flow.

The FAQ style organizes a piece around the questions a real reader would actually type or speak, ordered by how likely each one is to come up. It is not an outline disguised as questions; it is a structure built from the reader’s mental model of the topic, not the writer’s. Done well, a reader can land on any single question, get a complete answer, and leave - or stay and read the next one because it is the next thing they would naturally ask.

Three disciplines distinguish a real FAQ from a fake one. First, the questions must be in the reader’s voice, not the writer’s - “How do I cancel?” not “On the topic of cancellation.” Second, each answer must be self-sufficient. A reader who arrived via search or a deep link should not need to read the preceding question to make sense of the current one. Third, the order is empirical: which questions come up most often, asked first. Logical flow is a secondary concern, and sometimes a casualty.

The FAQ is fundamentally a multi-entry-point format. The reader is not expected to read it linearly. This is its strength when the audience is heterogeneous and its weakness when the material needs to build a single conceptual model: each answer in isolation cannot do what a sustained explanation can.

  • Each section header is a question phrased the way a reader would actually ask it, not a topic
  • Questions ordered by frequency or urgency of being asked, not by logical dependency
  • Each answer is self-contained - a reader arriving at one question via search should not need to read earlier ones
  • Answers are direct and lead with the answer, not the setup (“Yes, you can. To do it…” not “Many users wonder…”)
  • Cross-links between related questions are explicit when an answer depends on context from elsewhere

Support documentation where readers arrive via search, product help pages with heterogeneous audiences, onboarding material covering questions of varying scope, policy or compliance documents that need to be navigable.

Material that builds a single conceptual model the reader must absorb in order, narrative or reflective writing, content where the reader has not yet formed any questions, tutorials with a single intended path.

technical-writer, instructional, technical-reference, readme

how-to-tutorial: A how-to tutorial assumes a single ordered path - step one, then step two, then step three - and the reader is expected to follow that path. An FAQ assumes many readers arriving at many points, each needing only their one answer. If the material has one correct order, it is a tutorial; if it has many, it is an FAQ.

Write using a frequently asked questions structure. Each section header is a question phrased the
way a real reader would ask it, in their voice, not yours. Order the questions by how likely or
urgent they are to come up, not by what would make a tidy outline. Each answer must be
self-contained - a reader who arrived at one question via search must not need to read the others
to understand it. Lead each answer with the answer itself, not setup. If two answers depend on
shared context, repeat the context or cross-link explicitly. The reader is not reading top to
bottom; treat every question as an entry point.

Technical Writer, Instructional, Technical Reference, README

Pastoral, Storyteller

How-To Tutorial

Async-first standups: FAQ for the 30-day trial

Section titled “Async-first standups: FAQ for the 30-day trial”

Most days, no one will notice for a few hours. By 11am local your manager will ping you. If you forget twice in a week, the team lead will check in. The post is meant to take 90 seconds. If you are forgetting, the friction is probably not memory, it is that the format is not working for you. Tell us, do not just absorb the miss.

How do blockers actually get resolved without the meeting?

Section titled “How do blockers actually get resolved without the meeting?”

Three fields, one of them is “blockers.” If you have a blocker, you @mention the person who can unblock you in the same post. They get a notification. If they do not respond within their working hours, you escalate to the team channel. The standup meeting was not resolving blockers faster than this anyway. We checked: in the last 10 standups, 2 blockers were resolved in the meeting itself, the other 6 were resolved in side conversations afterward.

I am new to the team. Does this work for me?

Section titled “I am new to the team. Does this work for me?”

Honest answer: it is harder for new joiners and we know it. For your first 30 days, you get a 20-minute weekly sync with your onboarding buddy. Use it for the questions the standup used to surface for you. After 30 days, you will know who to ping for what, which is the actual skill the standup was teaching you, just slower.

What about the social part? I liked seeing everyone.

Section titled “What about the social part? I liked seeing everyone.”

This is the most common pushback and it is real. We are not removing all sync time. We are keeping the Friday team call (45 min, half social, half demos). The standup was never very social anyway, it was 11 people on mute waiting their turn. If you want more human contact than Friday provides, propose something. We will fund it.

Do I have to post if I have nothing to report?

Section titled “Do I have to post if I have nothing to report?”

Yes, even one line. “No movement on X, picking up Y today, no blockers.” The post is not just status, it is presence. Skipping creates ambiguity: did you not work, or did you forget to post? One line resolves that in 10 seconds.

What if my manager wants more detail than three fields?

Section titled “What if my manager wants more detail than three fields?”

That is a one-on-one conversation, not a standup conversation. The three fields are for the team. If your manager needs more, they should be getting it in your weekly 1:1, not by reading every standup post.

Will Priya and Arjun finally be in the loop?

Section titled “Will Priya and Arjun finally be in the loop?”

That is the main reason we are trying this. They currently attend 3.2 of 5 sessions. With async, the floor for “being in the loop” stops being “you woke up at 9:30pm.” We will measure this. If after 30 days they report still feeling out of the loop, the experiment failed even if attendance numbers look good.

Four signals, measured at day 30:

  1. Self-reported clarity on what teammates are working on (survey).
  2. Self-reported attendance burden (especially for India-based engineers).
  3. Time to blocker resolution (compared to a baseline we capture this week).
  4. Number of “I did not know you were working on that” moments in retros.

We go back. The proposal is a 30-day trial, not a permanent change. The reversal cost is one team meeting. Do not catastrophize and do not silently endure. Speak up at day 15.

Yes. Nothing prevents two people from getting on a Zoom to work through something. The thing we are removing is the mandatory daily group call, not the option to talk.

Who do I talk to if I have a concern not covered here?

Section titled “Who do I talk to if I have a concern not covered here?”

DM the team lead. Concerns shape the trial. The FAQ will be updated as new questions come in.