TE
科技回声
首页24小时热榜最新最佳问答展示工作
GitHubTwitter
首页

科技回声

基于 Next.js 构建的科技新闻平台,提供全球科技新闻和讨论内容。

GitHubTwitter

首页

首页最新最佳问答展示工作

资源链接

HackerNews API原版 HackerNewsNext.js

© 2025 科技回声. 版权所有。

Motivating Developers to Care About Documentation

16 点作者 nelsonmarcos大约 3 年前

3 条评论

cc101大约 3 年前
It's not a matter of motivation. Programmers reduce the verbal understanding of their work to non-verbal symbolism. That's necessary to work efficiently in long complex projects where many ideas have to be manipulated. It is very distasteful to re-verbalize work that has been reduced to symbolism.
评论 #31148019 未加载
tedyoung大约 3 年前
&gt; If you’re taking documentation really seriously, put it on the scorecard. Look for good writers. ... Then put it in your career ladders too. It’s a competency that individuals need to develop if they’re to move to the next level.<p>Exactly. If it&#x27;s not evaluated and rewarded in the same way shipping code is (in hiring, too, as mentioned), it&#x27;ll never be treated as important by developers. Devs are generally rational: if you say &quot;write docs!&quot;, but then complain when things take longer because they were taking time to write docs, well, then you can guess what will happen.
pydry大约 3 年前
IME the biggest killers of documentation are:<p>1) no time set aside to keep it up to date.<p>2) the tedium of reflecting changes made in one place in 3 others.<p>3) the fact that the MVP of a lot of organizations is the go to guy who can answer all the questions while amazing documentation is quickly taken for granted &amp; rarely personalized.