[theletterf]

There’s an irresistible, almost demoralizing irony in the fact that developers are discovering docs and accessibility only now due to AI. They needed docs and didn’t know it until they had at their disposal an ersatz user in the form of an LLM that asked for context.

https://passo.uno/skills-are-docs/

[dsjoerg]

Strongly agreed. However, some developers have trouble writing clearly and reading lots of text, and therefore prefer oral and interactive + real-time transmission of the information. Those developers, I suppose and hope, are discovering that they can talk out loud to their agents, explain everything interactively, and then the agent can create whatever longer-term artifact it wants to record the understanding. Multi-modal interfaces FTW?

[AlexeyBelov]

At $job and $previousJob we (the devs) were never given time to properly keep the documentation up-to-date. It didn't matter that people were asking the same questions and discovering the same things again and again.

Now, at $job, there is a top-down directive for quickly documenting every part of every important workflow and every idiosyncrasy of our products.

So, developers knew that all along.

[jiggawatts]

When one of the top Anthropic people said something along the lines of “Our users that invested heavily into their documentation are the best positioned to reap the benefits of AI tooling” I just laughed and laughed, then gazed upon the bare plains of comment-free spaghetti code written by developers who don’t even work here any more.