如何處理第三方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個月的時間內，我使用的版本不再公開。