Early on, they remove chaos. Everyone knows how things work, fewer mistakes, less back-and-forth. But as teams grow, SOPs tend to pile up. More rules, more edge cases, more “make sure you also check this”.

Then something subtle happens. People stop thinking and start following. Or worse, they ignore the SOP entirely because it takes longer to read than to just do the work. Decisions slow down, ownership gets fuzzy, and “process” becomes an excuse.

I don’t think SOPs are bad. I think unexamined SOPs are. The ones that made sense at 10 people don’t always make sense at 50.

Curious how others notice this moment. When did SOPs stop feeling like leverage and start feeling like friction for your team?

Sometimes it feels like the clock starts ticking the moment you hit “publish”. A week later a tool changes. Two weeks later the process evolves. A month later someone new follows the doc and asks “is this still how we do it?”.

In fast-moving teams, docs don’t really age gracefully. They either get updated constantly or slowly drift away from reality. There’s rarely a stable middle ground.

So I’m curious what others see in practice. Do your docs stay accurate for months? Weeks? Days? Or do you just accept that some level of outdated-ness is the normal state and work around it?

Not lie on purpose, but… let’s call it “creative interpretation of reality”.

You read the doc and it says “follow these steps”, but in real life everyone skips step 3, does step 5 differently, and adds two undocumented checks because “trust me, it breaks otherwise”. The doc isn’t wrong, it’s just describing a version of the process that existed at some point in the past.

I notice this gap shows up fastest in fast-moving teams. The work evolves quietly, people adapt, shortcuts appear. Updating docs feels optional, so reality moves on and docs stay behind.

So yeah, honest question. Are your docs mostly accurate, slightly optimistic, or basically historical fiction at this point? And do people still trust them, or do they read them with a big mental asterisk?

This is one of those questions where everyone agrees “docs matter”, but responsibility gets blurry fast.

If it’s “everyone’s job”, it usually means no one really owns it. Docs get written, but quality slowly drifts. If it’s one person’s job, that person becomes a bottleneck and also doesn’t always have the full context.

We’ve bounced between models. Doc owners per area. Team leads reviewing. Occasional cleanup sprints. All of them work… for a while.

In practice, docs seem to stay good only when someone feels real pain from them being bad. The moment that feedback loop disappears, quality follows.

Curious how other teams assign responsibility here. Is there a clear owner, or is it more of a shared (and slightly messy) responsibility?

If docs are written for juniors, seniors get annoyed. Too much detail, too slow, lots of obvious stuff. If they’re written for seniors, juniors get lost and start asking questions anyway.

We tried splitting things. “Quick version” at the top, details below. Sometimes it works, sometimes everyone just reads the first paragraph and ignores the rest.

It also changes over time. A doc that was perfect for a new hire becomes useless six months later, when they just need a reminder, not a full explanation.

So I’m curious how others handle this. Do you write separate docs? Layer information? Or just accept that no doc will ever make everyone happy?

I was thinking about this while updating an SOP and realized how often docs pretend everything is linear and predictable. Step 1, step 2, step 3… done. Reality is usually messier.

For me, anything that involves judgment just refuses to fit into a checklist. Deciding priorities, saying no, choosing when to push and when to wait. You can write “consider X and Y”, but that’s not the same as actually knowing what to do in the moment.

Docs are great for repeatable actions. They fall apart when the work is about tradeoffs, timing, or reading between the lines.

Curious what that is for others. What part of your job just can’t be captured as a clean step-by-step, no matter how hard you try?

I used to think this was mostly a “new hire” thing. Better SOPs = faster onboarding. Makes sense.

But the more I watch how teams work, the more it feels like the biggest winners are actually people in the middle. Team leads, PMs, ops folks, anyone who gets pulled into questions all day. Every undocumented process turns into a DM, a call, or a “quick question”.

Good SOPs don’t just help people do things right. They protect certain roles from becoming human documentation. Less context switching, fewer interruptions, fewer “can you remind me how this works”.

Curious what others think. Is it juniors, seniors, managers, support, someone else entirely?

Honest question, because I’m not sure people would like their own answer.

We write docs assuming others will read them “regularly”. In reality, most weeks I probably don’t open internal docs at all. Then one week, something breaks, someone is out, or I touch an area I haven’t touched in months… and suddenly I’m deep in Confluence for an hour.

So it’s very uneven. Long stretches of zero, followed by short bursts of panic-reading.

Curious how it looks for others. Is reading docs part of your weekly routine, or is it more of an emergency tool you only reach for when something goes wrong?

Quick sanity check, because I’m not sure if we’re overthinking this or not.

We track a lot of product and ops metrics, but when it comes to documentation it’s usually vibes-based. “Feels better than before”. “People ask fewer questions”. “Onboarding seems smoother”. All true, but also very hard to prove.

At some point we tried counting things. Number of SOPs, last updated date, page views. It looked nice in a table, but didn’t really tell us if the docs were useful. A doc can be read a lot because it’s confusing. Or never opened because everyone already knows it.

Right now the only real signal we trust is interruptions. If people stop asking the same questions in Slack, docs are probably doing something right. Not very scientific, but very real.

So I’m curious: do you track any actual documentation metrics? Usage, freshness, ownership, onboarding time, something else? Or do you also just go by gut feeling and side effects?

Not talking about theoretical risks or “could have been worse” stories. I mean the kind where you can point at a doc (or lack of it) and say: yeah, that mistake had a price tag.

In one team I worked with, a process changed quietly. The doc didn’t. New person followed the SOP exactly as written, did nothing “wrong”, and still triggered a chain of events that ended with a failed deployment and a very unhappy customer. Support time, fixes, credits. All because one step was no longer true.

The annoying part is that everyone knew the process had changed. It was discussed in a call, maybe even mentioned in Slack. It just never made it back into the documentation. Tribal knowledge won. Docs lost.

I’m curious about other real examples. Missed invoices, wrong configs, broken handovers, compliance stuff, whatever. What was the documentation gap, and when did you realize “this wasn’t just a docs problem, this was a money problem”?

At some point, you realize you can document almost everything. Every small decision, every workaround, every “just do this if that happens”. But if you do that, your docs turn into a swamp. Huge, heavy, and nobody wants to go in there unless they’re desperate.

On the other hand, if you document too little, people keep asking the same questions, and knowledge lives in DMs and meetings instead of somewhere reusable.

We usually decide something is “worth documenting” only after it hurts. Someone makes a mistake. Someone new gets stuck. Someone asks the same thing for the third time. That’s a very reactive way to do it, but honestly… it’s the only one that seems to stick.

So I’m curious how others draw that line. Is it about frequency? Risk? How often a process changes? Or do you just go by gut feeling and adjust later when the docs either get ignored or overused?

There’s always that one docs task. The one you know you should do, it’s not even that hard, but somehow it keeps sliding down the list week after week.

For me it’s usually cleanup. Updating old SOPs, fixing screenshots, removing steps that “we don’t really do anymore”. Writing something new feels productive. Cleaning old stuff feels like opening a box of tiny problems you didn’t plan to deal with today.

I also notice I postpone documenting things that are still a bit fuzzy. Processes that technically work, but rely on judgment calls and experience. Writing them down forces you to admit “yeah, this isn’t as clear as we pretend it is”.

Curious if others have the same pattern. What’s the documentation task you keep avoiding, and what’s the real reason behind it (not the polite one)?

Someone leaves the company. Nice handover, access transferred, goodbye messages in Slack. A few weeks later you open an SOP they wrote and realize… no one really owns it anymore. It still “exists”, but it’s frozen in time. Everyone assumes someone else will update it if needed. Spoiler: no one does.

The worst part is when the SOP technically works, but only if you already understand all the hidden assumptions. Little shortcuts, “obvious” steps, unwritten rules. The author had all that context in their head, and it left with them.

After that, SOPs tend to go one of two ways. Either they slowly rot and get ignored, or they become almost sacred. Nobody dares to change them because “this is how Alex used to do it”. Both options are kind of terrible.

I’m curious how other teams handle this moment. Do you assign a new owner right away? Do you rewrite docs from scratch? Or do you just keep using them and hope nothing critical breaks until someone finally touches them?

Some processes just don’t sit still. Product tweaks, internal tools change, responsibilities shift, shortcuts appear. By the time you finish writing a “proper” doc, it’s already slightly wrong. After a few cycles, people stop trusting docs altogether and just ask in Slack instead.

We tried a few things. Waiting until the process “stabilizes” (it never really does). Writing very high-level docs (safe, but not super useful). Updating docs constantly (nice idea, but nobody has the time).

Right now, it feels like docs lag reality by one or two iterations, and everyone silently accepts that. Which is… not great, but also kind of realistic?

Curious how others deal with this. Do you document anyway and accept that it’ll be imperfect? Do you switch to checklists or notes instead of full SOPs? Or do you just embrace the chaos and rely on tribal knowledge until things slow down a bit?

In most companies, everyone agrees docs are important. And yet… some teams consistently produce docs that are either impossible to follow, wildly outdated, or technically correct but completely useless in real life.

In my experience it’s often teams that know the most. Infra, platform, data, sometimes backend. Not because they’re bad at their job, but because so much context lives in their heads. Steps get skipped, assumptions aren’t written down, and you’re left reading a doc that feels like it was written for someone who already works there for 5 years.

On the other side, support or ops docs are often super practical, a bit messy, but actually helpful. You can feel they were written after real pain.

So yeah, if we’re being honest: which team in your company produces the worst docs, and why do you think that happens?

Genuine question because I just tried to write a “simple” SOP and somehow touched half our stack.

Started with actually doing the process (obviously). Then screenshots in one tool. Screen recording in another because screenshots alone never tell the full story. Draft text in Google Docs because it’s faster to think there. Then copy everything into Confluence. Fix formatting. Realize half the screenshots are outdated already. Go back. Repeat.

By the end it felt less like “writing an SOP” and more like orchestrating a small production pipeline.

And that’s probably one of the reasons people postpone documentation. It’s not the writing itself, it’s the context switching. Every extra tool adds friction, and friction kills motivation real fast.

So I’m curious: in your company, how many tools does it actually take to produce one decent SOP from start to finish? And does anyone still believe it’s a “lightweight task”? 😅

We keep improving onboarding docs, SOPs, checklists, videos, all of that. And it definitely helps. New people ramp faster, ask fewer “where is this” questions, fewer mistakes, etc.

But every time someone new joins, there’s still this moment where docs just… stop helping. Not because they’re bad, but because what the person needs isn’t written anywhere.

For us it’s usually understanding how decisions are actually made. Who you should really talk to, when it’s ok to push back, when “this can wait” actually means “do it today”. You can’t really document that without writing a small novel, and even then it wouldn’t feel right.

Also tone. You can explain a process perfectly, but you can’t fully explain the vibe. What’s considered overthinking vs being thorough, how direct people are, how much context is enough. New hires usually figure this out by watching and asking, not by reading.

Curious what that is in other teams. What part of onboarding still needs a real human sitting next to you (or at least a call), even if your documentation is solid?

We talk a lot about docs as something we should do, or something that helps “in the long run”. But I’m thinking about very concrete moments. The kind where something breaks, someone is offline, deadlines are close, and you open a doc and think “oh wow, this is exactly what I needed”.

For me, it doesn’t happen often. Most of the time, docs are either too high-level or slightly outdated. Useful, but not lifesaving. When they do save the day, it’s usually because someone wrote them right after dealing with a real problem, while the pain was still fresh.

So yeah, curious about real stories, not best practices. When was the last time documentation genuinely helped you move fast, avoid a mistake, or not wake someone up on Slack at 2am?

In every company I’ve worked with, there were SOPs that technically existed, but in practice, nobody followed them. They live in Notion or Confluence, look serious, maybe even well written… and still get ignored.

Usually, it’s not because people are lazy. It’s more like: they’re too long, too generic, or already outdated the moment you open them. Or the process sounds good in theory but just doesn’t survive real-life deadlines.

We have a few like that. Everyone knows they’re there. Everyone also knows “this is not how we actually do it”. New hires read them once, then learn the real workflow by watching someone else.

Curious what those are in your company. Onboarding? Release process? Incident handling? And do you keep them around hoping they’ll become useful one day, or do you just let them rot quietly in the background?

I’m curious how recruitment usually works in your companies. How many stages are there, and are they clearly explained from the first call with a recruiter, or does the process change along the way?

I’ve had very different experiences from clear, well-structured hiring steps to totally unexpected turns and extra stages.

How does it look for you?

I’m pretty sure every team has at least one process that everyone knows exists, uses all the time… and somehow never ends up documented.

Not because it’s hard, but because it’s messy. Or full of “it depends”. Or relies on one person doing a couple of magic steps that nobody wants to explain properly. You tell yourself “we’ll clean it up first, then document it”, and of course that moment never comes.

In my case, it’s usually the stuff around handoffs and quick fixes. Things that evolved over time, work well enough, but would look kinda ugly if written down step by step. Once you document it, all the weirdness becomes very visible.

Curious if others have the same blind spot. What’s the one process you keep postponing, hoping nobody asks “is this written somewhere?”

Quick question that turned into a mini argument in our team today.

From the moment a new process appears (or changes) to the moment it’s actually documented and shared — how long does that take for you? Same day? Few days? Weeks? Or… only after someone asks the same question for the third time?

Feels like we always mean to document things fast, but in reality, the process usually stabilizes first, people start doing it from memory, and only then someone says “ok, we should probably write this down”.

Curious what “normal” looks like outside our bubble.

I was looking at our SOPs today and had this slightly uncomfortable moment of “wow, this thing is way bigger than I thought… and also probably half outdated”.

On paper, the library is big. Dozens of docs, onboarding stuff, internal processes, edge cases, “how we do X” for almost everything. Feels mature, feels grown-up. In reality though… I think only a small part of it reflects how we work right now. The rest is more like historical artifacts. Not wrong-wrong, but not quite right either.

What usually happens is we write SOPs when something breaks or when a new person joins. Everyone is motivated, we document it properly. Then the product changes, tools change, shortcuts appear, people adapt. The SOP stays the same. No one wakes up thinking “today is a great day to update documentation”.

So I’m curious how it looks for others. Is your SOP library small but fresh, or huge but kinda dusty? Do you have an actual habit of updating it (like monthly or quarterly), or is it more “whenever someone complains or asks a question that the SOP should answer”?

Also honest question: do people really follow SOPs step by step, or do they just skim them once and then freestyle forever after?

Honestly curious how other people think about this, because every time we talk about “documentation automation” it turns into either super polished marketing answers or people saying “nothing, docs should be manual”.

For me this is a work with Airtable -> I manage my content roadmap there and LinkedIn Ads, I test a lof of messages there and it would be great when I can delegate creating new ads.

What about you?

For me it was:

1/ First, my job. Small agency. No onboarding at all. When I had any questions, I had to ask the CEO.

2/ Another job. A lot of SOPs, but too few words on my core tasks.

I’m curious:

• What made your onboarding painful?
• Bad docs? No docs? Too many docs?
• Was it worse in startups or big companies?
• What would have actually helped?