如何处理第三方Javadoc

时间:2009-10-29 10:21:41

标签: java version-control javadoc

想看看其他人如何处理第三方(供应商)java文档?他们是否受到源代码管理,所以每个人都可以访问它们?放在本地共享目录中?人们必须运作良好的其他解决方案。

我们使用clearcase并让开发人员和几个离岸团体一起在美国开展。

4 个答案:

答案 0 :(得分:4)

如果你有某种内部/外部网,我建议在一个地方收集所有内部/外部网。如果您不打算修改它们,我认为将它们置于版本控制之下没有任何好处。

答案 1 :(得分:2)

我将它们添加到源代码控制中。

我有

  • lib / for 3rd party jar files
  • lib-doc / for third party javadocs
  • lib-src /第三方来源

我发现这有利于将来参考,当我可能需要查找我使用的api的特定版本的源或文档时。可能是在6个月或12个月的时间内,我使用的版本不再公开。

答案 2 :(得分:1)

我们使用Trac

凭借其Bugtracker及其Wiki,您可以轻松管理项目所需的文档。此外,您还有许多适用于该工具的有用插件。我们不会将这种类型的文档放在我们的版本控制中,因为它会使我们的项目在一段时间后变大。

答案 3 :(得分:0)

当你使用'document'这个词时,我想你是在谈论javadocs?

使用Maven的项目可以处理这些事情。

对于其他项目,可以分享外部javadoc:

  • 可在网页上访问(只需配置您的环境以显示它们):这很容易设置,资源很容易,可能会不时地缓慢(或缩小)......
  • 可在公共文件系统上访问:这并非总是可行或不切实际(想想您的离岸群体)
  • 在源代码控制中提交(可能在不同的地方,以便常见的同步任务不必检查它们):也很容易;可能是某些配置中的性能问题