代码改变世界

随笔档案-2009年06月

编写自文档化的代码

2009-06-21 23:02 by Anders Cui, 11620 阅读, 收藏,
摘要： 我们编写的代码需要具有高度的可读性，这样其他的程序员可以更容易地对代码进行修改和扩展。两种传统的方式是使用外部文档和编写大量注释，其实它们都不是好的选择。自文档化的目标是使代码成为良好的文档，一种人人可以读懂的文档，本文介绍了多种提高代码自文档化的技巧，最后给出了我最近在尝试的一种方式。 阅读全文