我的硕士论文题目是 "Survival of undocumented code in & how to maintain it"

Question

我必须提交我的研究计划，我很困惑从哪里开始写我的计划。我应该在研究方法部分使用哪种类型的方法。是否有任何解决方案来维护未记录的代码？

Answer 1

听起来您可能想要对处理未记录代码的人进行访谈/问卷调查。或许可以跟踪源代码存储库中随时间发生的变化（对编码器库中有详细记录的部分与未记录的部分进行了多少更改？）。所以开源项目可能是一个好的开始。我曾在商业环境中工作过，那里有很多编码人员基本上没有记录，但可能很难找到愿意公开谈论这些例子的人，更不用说交出回购访问权了。

关于解决方案，根据我的经验，最好以极度防御的方式维护任何未记录/记录不完整的代码（除非绝对必要，否则不要触摸它）并随时添加文档。

也有人认为“代码就是文档”，但这只适用于基础层面，绝对不会超出一定的复杂程度，无论如何只向您展示代码 做什么 而不是 应该做什么 （即应该是错误和意外的副作用成为功能）。