如何处理第三方Javadoc

Question

想看看别人用第三方（供应商）java文档做什么？他们是否置于源代码控制之下，这样每个人都可以访问它们？放在本地共享目录上？其他解决方案，人们必须很好地工作。

我们使用clearcase，开发人员通过美国以及一些离岸组织进行传播。

Answer 1

如果您有某种内部/外部网络可用，我建议在一个地方收集所有这些内部/外部网络。如果您不打算修改它们，我认为将它们保留在版本控制之下没有任何好处。

Answer 2

我们使用Trac

凭借其错误追踪系统和它的维基很容易管理您需要为您的项目文件。另外，你有很多有用的工具插件。我们不把这种类型的文档放在我们的版本控制中，因为它让我们的项目在一段时间后变得很大。

Answer 3

当你使用单词“文档”，我想你是在谈论javadocs？

使用Maven的项目需要处理这些事情。

对于其他项目，有可能有由共享外部的javadoc：

• 的网络上访问（只配置您的环境中显示它们）：这是很容易设置，易于对资源，也许是不时缓慢（或下降）...
• 一个通用文件系统上访问：这并不总是可能的或实际的（想想你离岸组）
• 在源代码控制中提交（可能位于不同的地方，以便常见的同步任务不必检查它们）：也容易;可能是某些配置中的性能问题

Answer 4

我将它们添加到源代码管理。

我已经

• 的lib /对第三方jar文件
• LIB-DOC /对第三方的javadoc
• LIB-SRC /对第三方来源

我觉得这适合未来的参考，当我可能需要找到我使用的特定版本的api的源代码或文档时。可能在6个月或12个月的时间内，我使用的版本不再公开。