我想知道是否将
Javadoc文件提交到我的项目的SVN存储库.
我已经阅读了有关SVN良好实践的内容,包括有关SO的一些有趣问题,但是没有一个专门针对javadoc处理问题.
起初我同意只有源代码应该被版本化的论点,并且我认为使用Eclipse或者从javadoc.xml ant文件重新构建javadoc非常容易,但我也想到了这些要点:
> Javadoc文件很轻,文本编码,并且可以使用diff工具轻松跟踪对这些文件的更改.
>轻松跟踪javadoc的更改似乎很有趣,因为在“公共”javadoc的情况下,它的任何更改都可能意味着API的更改.
>愿意查看javadoc的人不一定想要获得整个项目并进行编译,因此将其放入repo似乎是另一个允许有效共享/跟踪的好主意.
你对此有何看法?请用建设性的,非主观的论点回答.我有兴趣了解哪些案例场景鼓励Javadoc的版本化,这使它看起来是一个糟糕的选择.
解决方法
原文地址:https://www.jb51.cc/java/239753.html
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。