Что делать со сторонним Javadoc - PullRequest
Новая
       19

Что делать со сторонним Javadoc

3 голосов
/ 29 октября 2009

Хотите узнать, что другие делают с документами Java сторонних производителей (поставщиков)? Они попадают под контроль источников, чтобы каждый мог иметь к ним доступ? Размещено в локальном общем каталоге? другие решения, чтобы люди работали хорошо.

Мы используем прозрачный футляр, и разработчики рассредоточены по США вместе с парой оффшорных групп.

Ответы [ 4 ]

4 голосов
/ 29 октября 2009

Если у вас есть какая-то внутренняя / экстрасеть, я рекомендую собрать их все в одном месте. Если вы не собираетесь изменять их, я не вижу никакой выгоды в том, чтобы держать их под контролем версий.

2 голосов
/ 29 октября 2009

Я добавляю их в систему контроля версий.

У меня есть

  • lib / для сторонних jar-файлов
  • lib-doc / для сторонних javadocs
  • lib-src / для сторонних источников

Я считаю, что это хорошо для использования в будущем, когда мне может понадобиться найти источник или документы для конкретной версии API, которую я использую. Может случиться так, что через 6 или 12 месяцев версия, которую я использую, больше не будет общедоступной.

1 голос
/ 29 октября 2009

Мы используем Trac

Благодаря Bugtracker и Wiki легко управлять документами, необходимыми для вашего проекта. Кроме того, у вас есть много полезных плагинов для этого инструмента. Мы не размещаем этот тип документов в нашем контроле версий, потому что через некоторое время наши проекты становятся большими.

0 голосов
/ 29 октября 2009

Когда вы используете слово «документ», я полагаю, вы говорите о javadocs?

Проекты, использующие Maven, заботятся о таких вещах.

Для других проектов может иметь внешние javadocs, совместно используемые :

  • доступно в сети (просто настройте свою среду для их отображения): это легко настроить, легко использовать ресурсы, может время от времени быть медленным (или не работать) ...
  • доступно в общей файловой системе : это не всегда возможно или практически (подумайте о ваших оффшорных группах)
  • зафиксировано в управлении исходным кодом (возможно, в другом месте, так что обычные задачи синхронизации не должны их проверять): также легко; может быть проблема с производительностью в некоторых конфигурациях
...