Какой инструмент/формат Вы используете для записи Ваших спецификаций? [закрытый]

Мы использовали TEX (MikTeX), и это было прекрасно потому что:

• текст жалобы - редактирует в Vim/Блокноте - просто везде
• мощное форматирование с помощью предопределенных макросов один из нас сделало
• поколение onclick к PDF

Единственная проблема должна была получить схемы (от ArgoUML) в.

В другом проекте я видел использование шаблоны Word - ужасный материал, направленный сверху.

Я рассмотрел бы использование чего-то как Wiki/форум на интранет. Предположите использовать GoogleDocs - существует управление версиями, он онлайн.. но не применимый для коммерческой разработки.

Я приехал для использования DocBook для всех таких вещей. Это легко, гибко, и генерирует HTML, tex (и таким образом PDF), и т.д.

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

На работе много наших документов идет под Sharepoint или некоторой другой системой документа, которая действительно замедляет "выпуск" документа. Это означает, что существуют копии документов повсеместно, и то, чтобы заставлять кого-то правильно выпустить что-то является головной болью. Из-за этого я обычно получал спецификации в месте подачи питания или макулатуре. Таким образом, я поднял Wiki (Медиа Wiki) на работе, что мы теперь удерживаем все спецификации проекта. Это позволяет им быть видимыми любым в компании и доступными для редактирования нашей группой разработки. Иногда разработчик будет просить у босса разъяснение, как они проходят мимо или безотносительно и разработчик может обновить спецификацию сами, которая я думаю, огромное преимущество. Кроме того, когда люди обновляют спецификацию с новой информацией с помощью истории, очень легко видеть то, чем новые изменения были - значение I видит то, что происходило, прежде и что потребности произойти теперь, то, которое я думаю, является огромным преимуществом.

Я все еще сохраняю спецификацию, которая была набросана на некоторой статье ноутбука о моей стене как напоминание.

На работе мы используем Wiki, потому что они являются великими для сотрудничества, но Microsoft Word будет работать.

Вы можете на самом деле разность две различных версии документа Word с помощью самого Word - это использует "функцию" изменений дорожки для показа различий. (Если Вы не верите мне, попробуйте diffing две версии использования документа Word TortoiseSVN.)

Для длинных документов я на самом деле предпочитаю Word по Wiki, потому что это хорошо подходит для редактирования длинных документов, и бизнес-люди являются более удобной работой с документами Word.