[DiggyJohnson]

Always funny to see these sort of missed connections on HN.

> internal blogs

In my personal experience the problem is the total lack of writing culture at non-premiere companies.

Put differently: unless you’re working on a great team at a great organization roughly 90% of people cannot be expected to write/read well as a component of technical collaboration. Any thoughts on that? I may just be too cynical

[throwaway2037]

From my personal experience, internal Wikis are 90+% written by about 5% of the workforce. The vast majority of internal Wiki users are "read-only". That is fine. Really: Read that twice. It is OK that the vast majority of docs are written by the few who are highly motivated to do it. When I write for an internal Wiki, I am trying to reduce the number of future questions that people will ask me. If they do come with a question, my first answer is always: Did you search our Wiki? It only takes once or twice for them to change.

[DiggyJohnson]

Appreciate the answer, I do think that is a good perspective.

[tracker1]

I'm not sure it's really cynical at all, in my experience, even with a LOT of wiki documentation, it is almost always severely out of date and many people don't know what is where... after a while, there's new, new, new versions of docs because people didn't want to refactor existing docs someone else created. And, in the end, almost nobody reads it and just ask other, more senior people within the team/org.

This is, of course, without explicit management directives to update documentation as a task/chore. Much like in many (most?) orgs, churning through technical debt is rarely a priority.

That said, no place is perfect and it takes only a handful of people to improve a culture, but without at least management support and/or fostering such a culture, it doesn't tend to happen.

[mlinhares]

But the non-premiere companies also do not hire the talent that is capable of doing this (and that might be fine, they might not really need that specific talent).

I've many friends that worked most of their carreers in small to medium companies where this wasn't a thing and stuff mostly worked. We can't expect to replicate the high end tech experience everywhere, I doubt it is a good investment of resources.

[torton]

This is rather likely to get worse.

Reading comprehension is declining. Emphasis on individual "impact" and deadline pressure, common at both premiere companies and "non-premiere" companies mindlessly copying the former, both consume time that could have been spent thinking, writing, and engaging with optional things others wrote. People who avoid documents because they might get outdated create systems with no documentation at all. And now, LLMs promise a world where documents don't need to exist a priori -- a model will look at your code and generate a plausible description of possible intent and system architecture on demand, if someone implausibly happens to ask for documentation. If nobody happens to ask, that's even more time saved - a win-win!

Leadership can either support or inhibit the culture of writing and reading. However, modern managers are not immune from the rising pressure. Their response is to shift from thinking and deliberate information processing to rapid-fire pattern matching. Some of them don't see documents as "real output" to begin with, and operate solely in meetings without any written record or documentation whatsoever. Of coures their staff will pick up on the pattern. I have a vivid memory of engaging with a full team working on a substantial project in the absence of their senior leader, getting the tactical picture and then asking the team about the project's goal. You could have heard a pin drop. None of the people working on the project could speak about anything but their immediate assigned tasks.