rvachev.orgEN / RU / πŸ€–
← Back to essays
Β· Essay Β· 1 min

Documentation is Coming Back

For a long time, the amount of documentation for code has been steadily decreasing. AI will break this trend.

<p>For a long time, the amount of documentation for code has been steadily decreasing. The Agile manifesto, "code is the best documentation," and constant changes made it outdated faster than it could be written.</p>
<p>AI will break this trend. The reason is simple: with a good specification, AI works significantly better. This creates a direct incentive to document.</p>
<p>I caught myself adding to frequently used notes - annual plans, thoughts after reading a book, lists - a separate MD file with a detailed description of the format: why this note is needed, what its structure is, how to update it.</p>
<p>Of course, I don’t write them myself - I generate them with the help of AI based on my thoughts.</p>
<p>Win-win: AI works more accurately, and it’s useful for me to reread these specifications after some time of not using them.</p>

<p>#ai #productivity #documentation #coding</p>
<p><a href="https://t.me/+OvImEUmA7W5mYTRi">β€”β€”β€”β€”β€”β€”β€”β€”β€” ΠœΡ‹ΡΠ»ΠΈ Π Π²Π°Ρ‡Π΅Π²Π° β€”β€”β€”β€”β€”β€”β€”β€”β€”</a></p>