Комментарии к статье

Technical Design Document: что, зачем и как

Ведущий программист проектов American Chopper 2 и Coded Arms: Contagion Анатолий Ахмедов рассказывает о техническом дизайн-документе - вещи довольно трудозатратной, но позволяющей избежать многих проблем на более поздних стадиях. Статья содержит описание того, что такое ТДД и зачем он нужен разработчику, плюс некоторые рекомендации по его написанию и конкретный пример структуры.
+4
Отправлено 08.06.2007 в 13:08
Отвечает на сообщение 202211
0
просто не стоит забывать :), что Его Величество Дизайн-документ состоит из трех частей (в одной обложке или в разных - это неважно):
1) концепт (Concept;
2) функциональная спецификация (Functional Specification)
3) техническая спецификация (Technical Specification)
Поэтому, если кто-то называет дизайн-документом некоторое количество листов бумаги, по сути, не соответствующих названию, - это его трудности :)
А по поводу содержания статьи - именно из-за того, что делается попытка разработать самостоятельный (диздока) документ и попадают в него такие разделы, как "список майлстоунов, оценки сложности задач..", которые к нему просто не могут иметь отношение.
Вот привожу copy-past оглавления соответствующего раздела диздока:
Введение
Принципы Игры
Платформа и ОС
Код, предоставленный сторонним разработчиком
Объекты кода
Управляющий цикл
Данные, относящиеся к игровым объектам
Хранение данных
Физическая модель и статистика игрока
Искусственный Интеллект
Мультиплеер
Интерфейс пользователя
Оболочка игры
Экраны игрового процесса
Графика и видео
Графический движок
Техническое описание графических элементов
Инструкции для художников
Звук и музыка
Инструкции специалистам по звуку
Специфичный код уровней
Отправлено 12.06.2007 в 19:51
Отвечает на сообщение 202210
0
Спасибо за статью. :)

Есть вопрос. Цитата:
"
Вам потребуется хранить историю изменений, одновременно редактировать документ несколькими пользователями. Потребуются шаблоны разделов. В минимальном варианте будет достаточно doc + source control, но в более сложных случаях потребуется поискать альтернативы.
"

Как хранить на практике историю изменений документов? Необходимо, чтобы человек видел какие изменения в документе произошли и где именно (например, добавились три объекта, но где? из сотни объектов человеку трудно найтри три новых появившихся причем в разных местах дока).

Связка .doc + Tortoise SVN не позволяет обеспечить хороший трекинг изменений документов. Переход на Wiki и прочее не помогает - нужны таблицы, а с ними сложно в Wiki. Чего делать? =)
Отправлено 13.06.2007 в 00:13
Отвечает на сообщение 203022
0
Антон Михайлов wrote:
>

> Как хранить на практике историю изменений
> документов? Необходимо, чтобы человек видел какие
> изменения в документе произошли и где именно
> (например, добавились три объекта, но где? из
> сотни объектов человеку трудно найтри три новых
> появившихся причем в разных местах дока).

Вики

> Связка .doc + Tortoise SVN не позволяет
> обеспечить хороший трекинг изменений документов.
> Переход на Wiki и прочее не помогает - нужны
> таблицы, а с ними сложно в Wiki. Чего делать? =)

Почему в вики с ними сложно? Может надо попробовать другой движок? у нас проблем не вызывает.
Отправлено 13.06.2007 в 13:50
Отвечает на сообщение 203034
0
Kirill Yudintsev wrote:
> > Связка .doc + Tortoise SVN не позволяет
> > обеспечить хороший трекинг изменений
> документов.
> > Переход на Wiki и прочее не помогает - нужны
> > таблицы, а с ними сложно в Wiki. Чего делать?
> =)
> Почему в вики с ними сложно? Может надо
> попробовать другой движок? у нас проблем не
> вызывает.


Использовали Trac. Основные проблемы возникли с таблицами - их гораздо удобнее редактировать в Excel. Кроме того и документы (диздоки и т.п.) удобнее создавать в .doc ибо есть потребность быстро и безболезненно редактирвоать тексты, добавлять картинки и т.п..

Была мысль сначала делать все в .doc/.xls, а потом перегонять в Trac, но геморно выходит. Пока работаем по старинке - через документы.
Kirill Yudintsev  13.06.2007 14:07
Антон Михайлов  14.06.2007 01:33
Kirill Yudintsev  14.06.2007 01:44
В ветке ещё 2 сообщения
Comments
Списки доступа
  • Подписчики [581]
  • Черный список [2]
Права доступа
Вы можете читать группу, но не можете отвечать на сообщения и создавать новые темы.
Доступ для остальных:
анонимы : могут читать
новые : полный доступ
постоянные : полный доступ

Copyright © 2019 ООО "ДТФ.РУ". Все права защищены.

Воспроизведение материалов или их частей в любом виде и форме без письменного согласия запрещено.

Замечания и предложения отправляйте через форму обратной связи.

Пользовательское соглашение