Thank you for choosing to share

Stop Generating More Documentation. Start Transferring Knowledge.

Writing documentation has never been a popular task among software engineers. In many cases, when you ask someone to write documentation, they just produce something to finish the task. And now, with AI, I think it's getting worse. Before AI, people often didn't write enough documentation. Now, they can generate pages of documentation in minutes. But sometimes, you need to spend a lot of time reading it and still can't understand what actually matters. Generating more documentation doesn't necessarily mean transferring more knowledge. I wrote an article about this problem, why I think it matters, and how we can improve it. I focused on three points: - Longer Isn't Always Better - AI Doesn't Have All Your Context - Know Your Audience: Humans or LLMs? I think we should be more responsible for the documentation we produce, even when AI does most of the writing. Read the article for more information