flâneur — a map of the web's best reading

Writing Culture is Agent Infrastructure - sohail mohammad

sohailmo.ai · 1,105 words · saved by 1 readers

Everyone's talking about AI replacing writers. But the orgs best positioned for AI agents are the ones with the strongest human writing cultures. i recently joined Amazon. Within a month, i had my first significant code change up. Within two weeks of adopting a new service, i was answering questions from people reaching out about how it works. Not because i'm some genius onboarder. Because the writing culture did the heavy lifting. The unfair advantage wasn't the tooling. It was the documentation. At previous companies, documentation was always a second thought. It was never given priority. The pattern was always the same: "okay let's now update the Confluence to account for the work we've done." But even then, it wasn't met with excitement, and it wasn't structured in a way that made it easy to parse out what the status or understanding of things are. It was broken up pieces of graphs and charts and fragments. At Wendy's, there wasn't much documentation at all. It was tribal knowledge

Everyone's talking about AI replacing writers. But the orgs best positioned for AI agents are the ones with the strongest human writing cultures. i recently joined Amazon. Within a month, i had my first significant code change up. Within two weeks of adopting a new service, i was answering questions from people reaching out about how it works. Not because i'm some genius onboarder. Because the writing culture did the heavy lifting. The unfair advantage wasn't the tooling. It was the documentation. The Problem: Docs as Afterthought ¶ At previous companies, documentation was always a second

Explore this link on the map →

saved by

related reading