假设
Classic ASP 系统的文档比较简单。
管理层不是在寻找重写。
由于您一直在使用 ruby on rails,因此您的 (VB/C#) ASP.NET 充其量是可以通过的。
我的经验
我也继承了一个经典的 ASP 系统,它被 ex excel-vba 类型随意地拍打在一起。有很多这样的东西<font size=3>crap</font>
(有时缺少结束标签;Argggh!)。在 2.5 年的时间里,我添加了一个安全系统、一个公共库、CSS+XHTML,并且能够强制验证 xhtml1.1(不幸的是,没有正确的 mime 类型),并构建了一个相当健壮和 ajaxy 的报告系统。每天有 80 位用户使用。
我使用了 jEdit,带有 cTags(正如上面的 jamting 所提到的)和一堆其他插件。
我的建议
尝试创建一个主包含文件,从中导入所有常用的东西。诸如登录/注销、数据库访问、Web 服务、javascript 库等的东西。
使用类。它们是超原始的(没有继承),但正如 jamting 所说,它们很方便。
正确缩进脚本。
评论
编写外部架构文档。我个人使用 LyX,因为生成格式良好的 pdf 是很费脑筋的,但你可以使用任何你喜欢的东西。如果您使用 wiki,请安装并使用 graphviz 插件。制作可以轻松修改的快速图表非常容易。
由于我不知道增强功能需要有多大,我建议拥有一份良好的中高级架构文档对于规划增强功能非常有用。
在业务逻辑单元测试中,我发现唯一可行的是在 asp 中设置一个 xml-rpc 侦听器,该侦听器导入主库并在任何主库的子包含中公开函数(虽然不是子例程),然后用一种语言单独构建一个单元测试系统,更好地支持通过 xml-rpc 调用 ASP 函数的东西。我使用 python,但我认为 Ruby 应该可以解决问题。(那有意义吗?)。很酷的是,编写软件的单元测试部分的人甚至不需要看 ASP 代码,只要他们对要调用的函数有适当的描述,所以他们可以成为你身边的人。
sourceforge有一个名为aspunit的项目,但最后一个版本是在 2004 年,它被标记为非活动状态。从未使用过它,但它是纯 vbscript。粗略地看一下代码告诉我,作者似乎知道他们在做什么。
最后,如果您需要帮助,我可以进行合同远程办公(最多 8 小时/周)。按照链接路径获取联系信息。
祝你好运!HTH。