我已经阅读了有关SVN良好实践的内容,包括有关SO的一些有趣问题,但是没有一个专门针对javadoc处理问题.

起初我同意只有源代码应该被版本化的论点,并且我认为使用Eclipse或者从javadoc.xml ant文件重新构建javadoc非常容易,但我也想到了这些要点：

> Javadoc文件很轻,文本编码,并且可以使用diff工具轻松跟踪对这些文件的更改.
>轻松跟踪javadoc的更改似乎很有趣,因为在“公共”javadoc的情况下,它的任何更改都可能意味着API的更改.
>愿意查看javadoc的人不一定想要获得整个项目并进行编译,因此将其放入repo似乎是另一个允许有效共享/跟踪的好主意.

你对此有何看法？请用建设性的,非主观的论点回答.我有兴趣了解哪些案例场景鼓励Javadoc的版本化,这使它看起来是一个糟糕的选择.