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

Question

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

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

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

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

Есть идеи?

Answer 1

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

И если вам не нравится редактировать XML-файлы напрямую, есть внешние интерфейсы GUI, которые обеспечивают разумную работу в стиле 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 , что также является отличным способом сотрудничества.)

Answer 2

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

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