2013年7月11日“无题”

上午先看了一下昨天一个哥们发的关于服务器启动时出现的一个异常，并不复杂，很容易看明白。其实并不是一个错误，而是 Log 的级别设置的不合适，并且在其中 new 了一个 RuntimeException。

下午主要就是为项目生成 Maven site 站点，这样进一步就可以在这个之上完善项目文档。这个项目文档里面可以存放项目的简介、相关模块的介绍、架构介绍、开发流程的介绍、功能和执行过程的介绍等等。还可以和 Java doc 结合，生成关联很多其它的报告，诸如项目依赖、测试覆盖率等等。

在这个过程中遇到了一些不算困难的问题，但也花了些时间。如因为公司内部 Maven repository 策略而无法下载到 Maven site 的 markdown 语法插件的一个依赖（asm-util-3.3.1）。改用默认的 APT 语法后 Maven site 运行时间过慢。Maven site 和 Javadoc 插件的结合等等。

最后 Maven site 终于初见模样，接下来的就是补充文档。对于复杂的项目，一边运行，一边对着日志跟踪代码是一个不错的方式。当然也可以通过启用远程调试的方式，但是这种方法有时会有问题，比如你断点暂停的一个线程是系统的关键线程，就有可能因为你的调试而使系统出错。