Программное обеспечение/платформа для обмена спецификациями

Какое программное обеспечение/вики вы используете, чтобы писать и делиться своими спецификациями о разработчиках, тестировщиках и менеджменте?

Используете ли вы систему Wiki, и если да, то какое программное обеспечение Wiki вы используете?

Или вы используете Sharepoint для управления спецификациями и их версий? Одна из проблем с SharePoint 2003 как платформой спецификаций заключается в том, что очень сложно сотрудничать между разными людьми.

Ради обратной совместимости я также хотел бы, чтобы платформа могла беспрепятственно импортировать Microsoft Word. И это, безусловно, помогло бы, если бы интерфейс был похож на Microsoft Word.

Есть идеи?


documentation specifications collaboration
person Graviton    schedule 16.06.2009    source источник

Ответы (12)


arrow_upward
4
arrow_downward

Я использовал Confluence во многих местах, это довольно мощная вики, и она очень удобна для создания спецификаций, которые могут быть переданы различным сторонам. Видеть:

http://www.atlassian.com/software/confluence/

Здесь есть дополнительная информация о преимуществах использования Confluence:

https://stackoverflow.com/questions/170352/confluence-experiences

EDIT: я обновил это, чтобы иметь дело с упомянутой вами функцией импорта Microsoft Word. Confluence поддерживает это через Office Connector здесь:

http://www.atlassian.com/software/confluence/plugins/office-connector.jsp

Также есть коннектор Sharepoint:

http://www.atlassian.com/software/confluence/plugins/sharepoint-connector.jsp

плюс куча плагинов:

http://www.atlassian.com/software/confluence/plugins/sharepoint-connector.jsp

Некоторые из них также внесены пользователями. Я не могу рекомендовать Confluence как коммерческую вики.

Я также использовал JSPWiki с открытым исходным кодом. это нормально, но не так хорошо, как слияние, см.:

http://www.jspwiki.org/

person Jon    schedule 16.06.2009

arrow_upward
3
arrow_downward

Вы можете попробовать Документы Google — я успешно использовал это в прошлом. Он поддерживает импорт/экспорт в MS Word, а также отличную поддержку нескольких пользователей — см. http://www.brighthub.com/internet/google/articles/8236.aspx.
Он поддерживает управление версиями, позволяет вам общаться в чате с другими людьми, которые в настоящее время работают над документом, и показывает вам список всех изменений, внесенных в документ другими пользователями (без необходимости закрывать/повторно открывать документ).

Если вам нужна корпоративная поддержка, Google также предоставляет ее — см. Google Apps для бизнеса. .

person a_m0d    schedule 24.06.2009

arrow_upward
2
arrow_downward

Мы используем SharePoint — он не идеален, но работает достойно. На вашем месте я бы серьезно задумался о переходе с SharePoint 2003 на MOSS (SharePoint 2007). Это не идеально, но существенно лучше. Вот немного об использовании MOSS в качестве вики. В общем, я думаю, что вики — хороший инструмент для того, чтобы люди могли быстро освоиться в вашей системе. Раньше мы раздавали «документы по началу работы», а теперь у нас есть все эти материалы на нашем портале для разработчиков.

Согласно комментарию Джона, я просмотрел это сравнение функций. Я должен вернуться и посмотреть, какие функции я использую, которых нет в WSS — возможно, я плачу за лицензии, которые мне не нужны! :)

person JP Alioto    schedule 16.06.2009
comment
@JP: могли бы вы сказать, что WSS 3.0 (бесплатная версия SharePoint) почти так же хороша, как MOSS 2007, в том, что касается такого рода сотрудничества? - person John Saunders; 16.06.2009
comment
Для чистой совместной работы с документами — да. Но если вам нужны такие вещи, как вики, блог, порталы, управление присутствием (коммуникационный сервер), вам нужен полноценный MOSS. - person JP Alioto; 16.06.2009
comment
Я использовал блог и вики в WSS 3.0 — версии, поставляемой с TFS. - person John Saunders; 16.06.2009
comment
Вы совершенно правы. Я не знал, что эти функции были частью WSS, а не MOSS. - person JP Alioto; 16.06.2009

arrow_upward
1
arrow_downward

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

person akf    schedule 16.06.2009
comment
Подождите, пока несколько человек редактируют одни и те же документы, и когда вам нужно искать страницы, только тогда вы почувствуете боль электронной почты. - person Graviton; 16.06.2009
comment
@akf: Очки предназначены для того, чтобы отражать готовность помочь, а не честность. - person mark4o; 22.06.2009
comment
извините, это прозвучало как опрос - person akf; 22.06.2009

arrow_upward
1
arrow_downward

Мы используем Alfresco в версии для сообщества как из веб-интерфейсов Share, так и из Explorer. Довольно полезный, с библиотекой документов, вики, форумом и календарем. В настоящее время у нас размещено около 1.8 Go, состоящее в основном из документов, версионированных и иногда автоматически конвертируемых в PDF (путем создания автоматического правила содержания). FTP, WebDav и сетевой ресурс также используются для доступа к тому же репозиторию.

person Arnaud Deslandes    schedule 16.06.2009

arrow_upward
1
arrow_downward

Вы можете взглянуть на Microsoft Groove — программное обеспечение для совместной работы, которое Microsoft купил несколько лет назад.

Он бесплатно поставляется в комплекте с премиальными версиями Microsoft Office.

Вы можете настроить рабочее пространство с помощью досок обсуждений и довольно легко хранить совместно отредактированные документы Office.

person Joe    schedule 22.06.2009

arrow_upward
1
arrow_downward

Мы используем MediaWiki для документации и спецификаций. Вики определенно выигрывает у Microsoft Word или SharePoint — она позволяет разрабатывать документацию по принципу «сначала обратитесь, затем опишите» = «разделяй и властвуй». Идеально подходит для разработчиков — раньше они думали так же. Процесс разработки документации почти идеален: вы начинаете с оглавления и углубляетесь, пока не напишите документ для каждой ссылки, которую вы разместили ранее.

MediaWiki достаточно настраиваемый — там много расширений. Самые необходимые из них:

  • Подсветка исходного кода — CSO_Source
  • Наши собственные шаблоны, объединяющие вики со ссылкой на класс.
  • Другими являются InterWiki, FileProtocolLinks, YouTube (мы используем его адаптированную версию для отображения HD-видео), ReCaptcha, SpecialDeleteOldRevisions, Maintenance.

Некоторые примеры интеграции находятся здесь.

И мы используем систему отслеживания проблем Google для отслеживания проблем. Его основные преимущества:

  • Ввод юзабилити: процесс добавления\изменения задачи там действительно удобен. Раньше мы пробовали Track Studio - там те же действия требуют в 2-3 раза больше времени, поэтому он быстро умер просто потому что большинство из нас ненавидело его использовать.
  • Настраиваемые сетки. См. примеры. Действительно полезно.
  • Поддержка Atom\RSS. Так что все знают, что происходит.
  • Существует инструмент Gurtle, объединяющий его с TortoiseSVN. Действительно полезно.

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

person Alex Yakunin    schedule 22.06.2009

arrow_upward
1
arrow_downward

Если вам нужен пользовательский интерфейс, похожий на Word, почему бы не использовать Word с SharePoint 2007? Вы на 2003 году, так что опыт есть. Обновите до SharePoint 2007, и вы получите совместную работу, функции Word, общий доступ к документам и т. д.

Это то, для чего Microsoft хочет, чтобы люди использовали Office, поэтому существует множество документов о том, как настроить среду SharePoint и Office для поддержки совместной работы.

person Robert S.    schedule 24.06.2009

arrow_upward
1
arrow_downward

Google кое-что делает в этом направлении, и это выглядит очень круто: wave.google.com. Это был бы отличный шаг в сотрудничестве и стоит подождать.

person Anton    schedule 24.06.2009

arrow_upward
0
arrow_downward

Здесь мы используем Google Docs, он делает документы доступными для всех только для записи или чтения, общедоступными или частными среди людей, у которых есть или нет учетные записи Google, он также может импортировать документы Word, не говоря уже о том, что он запускается непосредственно в браузере, поэтому он имеет высокую доступность с нулевой стоимостью и нулевой настройкой, а также ее независимость от компьютера / ОС, у нас есть хороший опыт работы с ней.

Также, возможно, вам следует взглянуть на Basecamp или Backpack на 37Signals, любой из них также может подойти вам.

person OldJim    schedule 27.06.2009

arrow_upward
0
arrow_downward

Мы используем DocBook для всех наших спецификаций (и другой документации для клиентов). DocBook — это формат XML, который позволяет легко создавать документы практически в любом формате, включая PDF, — именно так мы распространяем документы среди клиентов, чтобы они были подписаны. Мы можем разделить документ на файлы (по разделам) и зафиксировать все в нашей системе контроля версий (Subversion). Поскольку все это XML (т. е. основанный на тексте), автоматическое слияние и разрешение конфликтов в Subversion отлично работает, если два человека работают над одним и тем же файлом. У нас есть набор таблиц стилей, которые используются во всех наших документах, поэтому все документы имеют один и тот же стиль/формат без дополнительной работы с нашей стороны.

И если вам не нравится редактировать XML-файлы напрямую, есть интерфейсы с графическим интерфейсом, которые обеспечивают достаточно WYSIWYG-подобный опыт. Я считаю, что большинство людей в моем офисе используют XMLMind. Тем не менее, мы все являемся техническими специалистами, поэтому, если бы нам пришлось писать XML напрямую, это не было бы проблемой.

В качестве примечания мы также публикуем примечания к выпуску. У нас есть XSLT, который позволяет нам писать такие документы:

<bugs>
    <bug id="1234" component="web">JavaScript error when clicking the Kick Me button</bug>
</bugs>

Затем у нас есть скрипт, который проходит через наш репозиторий Subversion, выполняя svn log от тега предыдущего выпуска к тегу текущего выпуска, и некоторая интеграция с Bugzilla для автоматического создания примечаний к выпуску на лету.

(также для большей части документации только для внутреннего пользования мы используем MediaWiki, что также является отличным способом сотрудничать.)

person Adam Batkin    schedule 28.06.2009

arrow_upward
0
arrow_downward

Мы используем OnTime. Первоначально он использовался только для отслеживания дефектов, но мы начали использовать его и для отслеживания функций. Их можно использовать для документирования функции по мере ее развития в процессе разработки. Функции можно сгруппировать в спринты или выпуски, а время можно отслеживать для каждой функции. Если вы используете SCRUM, вы также можете построить диаграммы выгорания для каждого спринта. Он также имеет функциональность вики.

person adrianbanks    schedule 28.06.2009