Spiga

随笔档案 - 2009年6月

编写自文档化的代码

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