Отслеживание изменений в (функциональном) документе дизайна
Я ищу хороший способ усовершенствовать документ дизайна последних решений.
Мы - малочисленная команда (два разработчика, разработчик компьютерных игр, графический дизайнер, менеджер проектов, парень продаж). Большинство наших проектов длится несколько месяцев. В начале проекта сделан дизайн, но мы обычно вносим изменения или новые решения в течение проекта. Большинство этих изменений является улучшениями, таким образом, мы хотим сохранить наш процесс как этот. (Если измененным результатам дизайна в большее количество времени было нужно, это обычно заботится о, так, чтобы часть была в порядке),
Однако в данный момент у нас нет хорошего способа получить изменения в первоначальном документе дизайна, и это приводит к начальному дизайну, быстро отказавшемуся как источник при кодировании. Это - конечно, трата усилия.
В настоящее время наши документы являются OpenOffice/Word, и лучший способ отследить изменения в тех документах будет, вероятно, добавлять changelist к верхней части документа и вносить изменения в тексте параллельно — не действительно опция, я думал бы как идеал.
Я посмотрел на программное обеспечение управления требованиями, но это смотрит путь к специализированному. Документы могли храниться в подверсии, но я думаю, что это - слишком немного низкий уровень для предоставления понимания в изменениях.
Кто-либо знает, что хороший способ отследить изменения как они и сохранить дизайн документирует ценный ресурс в течение проекта?
Править: В данный момент мы главным образом полагаемся на изменения в первоначальном проекте, помещаемом в bugtracker, тот способ, которым они по крайней мере где-нибудь.
Править: Связанный вопрос
5 ответов
Я нашел, что Wiki с входом пересмотра работает хорошо повышением из документов Word, если число пользователей является относительно небольшим. Нахождение того, которое помогает сделать быстрые редактирования, полезно в обеспечении, это усовершенствовано.
И openoffice и слово включают capaiblities для показа/сокрытия редактирований к Вашему документу. Принятие там является сопротивлением изменению, затем это - Ваш наилучший вариант - или это или экспорт, чтобы написать и поместить его в любое программное обеспечение \управления исходным кодом
С другой стороны, поддержите отдельное (diffable использование соответствующего инструмента) документ для текста описания изменения и сохраните версии архива в соответствующих моментах времени.
Я не знаю хороших, свободных инструментов управления конфигурацией, но почему бы не поместить Ваш дизайн при управлении исходным кодом? Просто добавьте его к SVN, CVS, или независимо от того, что Вы используете. Это хорошо потому что:
1) Это всегда актуально (при регистрации его, конечно),
2) Это централизовано
3) Можно отслеживать изменения при помощи встроенного, сравнивают функцию, доступную почти в любой системе управления исходным кодом
Это не может быть 'enterprisish' решение, которое Вы хотели бы, но Вы - малочисленная команда разработчиков так или иначе, таким образом, для той ситуации, это более, чем прекрасно.
Править: Я вижу теперь, когда Вы уже упомянули систему управления исходным кодом, мою ошибку. Однако, я думаю, что это должно работать хорошо.
Используйте Google Docs. Его свободное, веб-, muti-пользователь в режиме реального времени, можно выбрать, кто имеет доступ к документам и сохраняет управление версиями. Можно также загрузить все документы слова, и это преобразует их для Вас. Для получения дополнительной информации: http://www.google.com/google-d-s/intl/en/tour2.html
Эта проблема уже давно существует и в нашем магазине программирования. Самое забавное, что программисты склонны смотреть на это с неправильной точки зрения оптимизации: «держать все в одном месте». На мой взгляд, у вас есть две основные проблемы:
- Описание изменений должно быть легко читаемым («Так что же нового?»)
- Процесс должен быть оптимизирован для написания спецификации, чтобы согласовать, а затем уже приступить к работе!
Представьте, как эта проблема решается в другой среде: правительственное законотворчество. Свод законов не переписывается с включением «отслеживания изменений» каждый раз, когда правительство добавляет новый закон или меняет один ...
Лучший способ - никогда не трогать опубликованный документ. Не помещайте все в один файл, вы получите:
- ужасная таблица истории версий
- вечный статус «черновик» ,
- разрозненные несоответствия,
- ужасно поспешные предложения и
- отвратительно пахнущая смесь авторских стилей
Вместо этого выпустите Приложение, в котором подробно описаны только изменения и, возможно, заменены полные абзацы / страницы оригинала.
С таким размером нашего проекта, это никогда не сработает, не так ли?
В моем самом большом на данный момент проекте я выпустил одну базовую спецификацию и 5 последовательных дополнений. Каждый по 5 страниц. Сработал как шарм!