Версия для печати темы
Нажмите сюда для просмотра этой темы в оригинальном формате
Форум программистов > УП: Общие вопросы > документация по проекту


Автор: Str!pe 8.2.2007, 11:39
добрый день всем.
Кто что может подсказать по теме документации по проекту. Интересет как это вообще делается. Пока сижу все на коленях делаю. Может у кого есть подобный опыт?

Автор: Rodman 8.2.2007, 12:15
не уверен, но http://www.google.com.ua/search?hl=ru&client=firefox-a&rls=org.mozilla:ru:official&hs=5kP&sa=X&oi=spell&resnum=0&ct=result&cd=1&q=%D0%BF%D1%80%D0%B8%D0%BC%D0%B5%D1%80+%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D0%B0%D1%86%D0%B8%D0%B8+%D0%BF%D0%BE+%D0%BF%D1%80%D0%BE%D0%B5%D0%BA%D1%82%D1%83&spell=1  такое

Автор: arilou 8.2.2007, 14:02
Str!pe, "на коленях" - это без документации?

Автор: chief39 8.2.2007, 16:13
Могу дать полный набор заготовок с пояснениями для RUP.
на аглицком.
Но, боюсь, что это обилие инфы просто завалит тебя и нихрена не поможет.
"Иногда гвозди всё-таки лучше забивать гвоздём а не свайной машиной"  smile

Опиши размер проекта, что предполагется, сколько людей писать будут и кто заказчик(перед кем отчитываться). И вообще -суть проекта. Будет ли он меняться в корне, что-то вполне конкретное .или тёмная лошадка. Может тебе много чего и не понадобится.

Добавлено @ 16:23 
Цитата(Str!pe @  8.2.2007,  11:39 Найти цитируемый пост)
ока сижу все на коленях делаю.

Да-да! Что именно на коленях делаешь?  smile 
Творение творишь? Или документацию наобум сляпываешь?

Автор: bilbobagginz 9.2.2007, 01:07
если вопрос о документации кода, и представлении оной в напр. html-ном виде, то есть инструменты.
если вопрос о документе планировки, то это делается и пришивается в проект, до реализации.
если вопрос о документации для пользователя, то легче всего взять смежную область, какое-то ПО, дока которого тебе нравится, и брать идеи оттуда.

в больших конторах используется человеческий компилятор документации - "технический писатель"


имхо всё конечно.

Автор: hetman 26.2.2007, 19:32
Цитата(Str!pe @ 8.2.2007,  11:39)
добрый день всем.
Кто что может подсказать по теме документации по проекту. Интересет как это вообще делается. Пока сижу все на коленях делаю. Может у кого есть подобный опыт?

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

Автор: unicuum 14.3.2007, 11:20
Цитата(Str!pe @  8.2.2007,  11:39 Найти цитируемый пост)
Пока сижу все на коленях делаю

Знаем мы что ты на коленях делаешь smile Уж точно не молишься smile

Думал над темой документации, читал книги, и вот к какому выводу пришёл. Какие бы системы ни пришлось для этого использовать, основная суть все равно идёт от создателя системы. Так чего думать то, пиши, так как единственный выход улучшить этот процесс это поручить его другому. smile


Автор: Str!pe 26.3.2007, 05:02
Сори за то что задал вопрос и пропал.

Цитата(arilou @  8.2.2007,  14:02 Найти цитируемый пост)
Str!pe, "на коленях" - это без документации? 

Есть прочтенный "Мифический человеко месяц" и никакого опыта.  Задача формулируется так: Описать проект и задать задачу программисту и дизайнеру. 

Цитата(chief39 @  8.2.2007,  16:13 Найти цитируемый пост)
Опиши размер проекта, что предполагется, сколько людей писать будут и кто заказчик(перед кем отчитываться). И вообще -суть проекта.

Три человека, делаем web-сервис, задачи очень конкретные в голове, а вот как эту конкретику донести до разарботчиков не треща по скайпу (удаленная команда), а выдав бумаг пачку что бы от туда и дальше черпать информацию а не ко мне с вопросами. Мне не нужен талмуд с историей гостов (хоть и интернесно), нужны какието общае рекомендации для начала.

Цитата(chief39 @  8.2.2007,  16:13 Найти цитируемый пост)
Будет ли он меняться в корне, что-то вполне конкретное .или тёмная лошадка.

Вполне конкретная тематика.

Цитата(chief39 @  8.2.2007,  16:13 Найти цитируемый пост)
Да-да! Что именно на коленях делаешь?   
Творение творишь? Или документацию наобум сляпываешь? 

документацию сляпываю smile

Цитата(bilbobagginz @  9.2.2007,  01:07 Найти цитируемый пост)
если вопрос о документе планировки, то это делается и пришивается в проект, до реализации.

Во! А как его составить?

Цитата(unicuum @  14.3.2007,  11:20 Найти цитируемый пост)
основная суть все равно идёт от создателя системы

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

Добавлено через 36 секунд
Цитата(hetman @  26.2.2007,  19:32 Найти цитируемый пост)
рекомендую DocBook спецификацию

А где это взять? И мануалы к ней....

Добавлено через 1 минуту и 48 секунд
Цитата(Rodman @  8.2.2007,  12:15 Найти цитируемый пост)
не уверен, но посмотри  такое 

Не оно :(

Автор: chief39 26.3.2007, 11:41
Гм.... ну чтоб вот так сразу уже на ходу и не возиться с проджект планами, конфигурейшн планами и проч(если проект не растягивается на долгое время и не окажется что это всё неплохо бы было иметь).
А также, если эта дока будет нужна только вам.

Описание общего видения системы, требования к функциональности, производительности, заделы для расширения.

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

Опиши список задач и укажи в пределах какой задачи что будет выполнено. Наметь сроки(учти что фиг угадаешь со сроками обычно сразу smile )

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

Опиши требуемую конфигурацию для всех (мини конфигурейшн план). То есть "такой-то томкат, такая-то версия того-то, установлено так и так, бежит под такой-то осью". Иначе потом начнётся "а у меня под виндой работало... ничё не знаю." Там же укажи где и как хранятся сорцы, как и что можно изменять, какие настройки, их изменение и вообще, работа с ними

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

Юзкейсы и тестовые планы описывай от руки, как Бог на душу положит - чтоб вам всем было понятно и больше конкретики.  То есть, не пиши "должно примерно так работать....", а пиши "то и то. Вызвали то - отработало вот так. при вызове - не должен изменяться такой-то объект и бла-бла". То есть учти сразу где может быть излишний полёт фантазии. Если полёт всё-таки есть - документируйте его, т.е. изменяйте требования.

Есть ещё куча всего, но, думаю, сейчас тебе это будет только в напряг.



Автор: Str!pe 26.3.2007, 14:28
Цитата(chief39 @  26.3.2007,  11:41 Найти цитируемый пост)
Опиши требования(юзкейсы) к каждой функциональности.

Моно хоть какой то примерчик, кусок выдраный хоть откуда, даж если не настоящий?

Цитата(chief39 @  26.3.2007,  11:41 Найти цитируемый пост)
юзкейсы

Что за зверь?

Автор: arilou 26.3.2007, 19:12
Str!pe, http://www.gatherspace.com/static/use_case_example.html

Автор: Str!pe 27.3.2007, 10:07
arilou, 
Вот не учил я, не учил английский, теперь придется! Спасибо, буду разбираться что это такое smile

Автор: arilou 27.3.2007, 10:13
Str!pe, по-русски это называется вроде "прецеденты использования", или что-то вроде.

Автор: chief39 27.3.2007, 14:15
Например модуль "банки"

Он отвечает за хранение, предоставление, изменение информации о банках в системе
источник данных - такие-то таблицы в общей БД(может какие-то требования или указание конкретной СУБД) или такая-то специальная БД, механизм выборки и обработки реализован в фасаде или таком-то модуле, он должен интергироваться с тем-то, так-то (и всё что полезно разработчику знать)

кэйсы:

Получить "банк" - такой-то метод с такими то аттрибутами банка, такие-то аттрибуты важны, влияют(может быть) таким-то образом. 
UI должен: вызывать этот метод, отображать то и то, отображать результаты в таком виде(или таком, или настраиваться так и так)
Можно вплоть до скриншотов 

Создать - так и так, этот аттрибут обязателен, эти данные доизвлекаются из такого-то модуля таким-то образом, УИ - оповещение о создании, отображение созданного, такие-то подсказки и словари данных и др и др..

Изменить

Удалить

Не допускать того-то
Испоьлзовать тот и тот модуль

То есть вам будет полезен документ где описано видение функционала, ограничения, требования пользователя. С этим девелопер может начинать детально проектировать модуль, подгонять его под остальные и общие, разрабатывать части и одновременно тестер может описывать тест-кэйсы по этому документу. Кроме того, полезно описать программные интерфейсы для взаимодействия модулей



То есть писать Какие действия надо протестировать, какие вараинты входных данных, ожидаемые результаты и проч и проч.
Аутомейтед-тестер может начинать писать автоматические/юнит-тесты
И в момент когда выйдет первый релиз модуля оба могут сразу упрогнать тесты и показать разработчику что пошло не так, чтоб он ориентировался уже на реалии, а не писал с закрытыми глазами тонны кода дальше


Кроме того, вам полезно будет описать общий документик(можно это всё в один слить)
туда внести
code conventions(требования к форматированию кода, именованию переменных, общих принципов проектирования классов, методов и подмодулей) - (если надо).
общие соглашения по УИ или внешним неким интерфейсам - тем самым избаляешь разработчиков от львиной доли колебаний при решении какую картинку поместить на форму, как распоолжить поля, как спроектировать и назвать некие внешине методы програмного интерфейса.

пардон, времени мало...






Автор: Str!pe 30.3.2007, 09:41
Цитата(chief39 @  27.3.2007,  14:15 Найти цитируемый пост)
То есть вам будет полезен документ где описано видение функционала, ограничения, требования пользователя.

Сейчас все мои действия сводятся к том что я делаю полностью макет страницы с расположением элементов. Все собираю в HTML - получается наглядный рабочий вариант, но без минимального дизайна. Каждый модуль разобран в отдельной странице по пунктам:
  • Список вывода
  • Динамика
  • Коментарии
Указания выдаются только таким образом и дизайнеру и программисту...
Фактически стараюсь делать полностью работоспособный проект (стандартными Дримуверовскими скриптами) который описываю, что не могу сделать просто обьясняю на пальцах...

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

Автор: batigoal 30.3.2007, 14:37
Фактически, у тебя получается functional spec. Однако неплохо бы еще иметь документ с описанием требований.

Автор: Str!pe 31.3.2007, 09:37
Цитата(batigoal @  30.3.2007,  14:37 Найти цитируемый пост)
functional spec

буду знать как называется smile
Цитата(batigoal @  30.3.2007,  14:37 Найти цитируемый пост)
документ с описанием требований

Поточнее если можно.

Автор: batigoal 31.3.2007, 16:33
В принципе, точнее некуда - описание требований является одним из фундаментальных понятий. Посмотри ссылки на литературу, там немало книг по вопросу работы с требованиями.

Автор: arilou 2.4.2007, 15:00
Str!pe, для создания прототипов попробуй Axure Pro. 

Автор: Shur 8.4.2007, 18:26
не дочитал до конца...

Но мне очень понравилось, как всё расписано на Иреоне - http://ireon.org
По-моему это то, что нужно.
Я там одно время переводил всякие документы, очень серьёзный с виду подход.

Автор: ida 10.4.2007, 11:07
Str!pe, у нас создаются:

1. Устав проекта
2. Иерархическая структура работ
3. Расписание проекта
4. Список контрольных событий
5. Реестр рисков 
6. Планы реагирования на риски
7. План завершения проекта
8. План управления коммуникациями 
9. План управления изменениями

Первые четыре - всегда, остальные - в зависимости от сложности проекта.
Причем это только документы по управлению проектом. Есть еще отдельно - при анализе, при тестировании, и т.д.

А если вам нужно поставить задачу, лучше наймите аналитика. Например меня smile

Экспериментировать в таких вещах нельзя. Я написала больше двух десятков ТЗ, и только на середине пути стала толком понимать, как это делается. Вы верите, что у вас это получится с первого раза?.... smile

Автор: chief39 10.4.2007, 13:19
Цитата(ida @  10.4.2007,  11:07 Найти цитируемый пост)
Экспериментировать в таких вещах нельзя. Я написала больше двух десятков ТЗ, и только на середине пути стала толком понимать, как это делается.

Мона и нуна smile Как он тогда научится без экспериментов? smile

Кста, не забудь про Configuration Management Plan

Автор: Str!pe 11.4.2007, 20:12
Спасибо всем за помощь, разбираюсь понемногу smile

Автор: pavelvladimirovich 24.7.2007, 16:33
Цитата(ida @  10.4.2007,  11:07 Найти цитируемый пост)
1. Устав проекта2. Иерархическая структура работ3. Расписание проекта4. Список контрольных событий5. Реестр рисков 6. Планы реагирования на риски7. План завершения проекта8. План управления коммуникациями 9. План управления изменениями


Если бы вы еще расписали подробнее каждый пункт по подпунктам и основным проблемам встречающимся на каждом этапе, было бы просто супер. Если есть время - очень прошу!

Автор: chief39 24.7.2007, 16:42
В аттаче заархивированный набор темплейтов. Вместо самого содержимого - описания того, что должно быть в содержимом.
http://www.7-zip.org/download.html(лично я не знал о таком smile )

Автор: pavelvladimirovich 24.7.2007, 16:54
Уважаемый chief а чем это открывать
Цитата

UBJECT  \* MERGEFORMAT <Project Name>
 TITLE  \* MERGEFORMAT Software Architecture Document
Version <1.0>


Я такого формата не видел а вот 7z вполне распространенный формат его винрар последней версии берет спокойно )

Автор: chief39 24.7.2007, 17:15
Цитата(pavelvladimirovich @  24.7.2007,  16:54 Найти цитируемый пост)
Уважаемый chief а чем это открывать

???
там один архив 7z. семьзетом открывается. Что и где не так идёт?

Автор: batigoal 24.7.2007, 17:28
У меня нормально распаковалось РАРом, внутри - вордовые шаблоны.

Автор: chief39 24.7.2007, 17:44
Цитата(batigoal @  24.7.2007,  17:28 Найти цитируемый пост)
внутри - вордовые шаблоны. 

Они самые

Автор: pavelvladimirovich 25.7.2007, 09:53
Цитата(chief39 @  24.7.2007,  17:15 Найти цитируемый пост)
Что и где не так идёт?


Все окей, забыл что офиса нет на компьютере. Разбираемся с содержимым..

Автор: zbuk 12.2.2008, 18:51

Дежурная библиотека шаблонов
http://www.tenstep.com.ua/open/miscpages/96.1TemplateCornerLibrary.htm

 На этой странице приведен список шаблонов, служащих дополнительной помощью для менеджеров, руководителей проектов и участников команд проектов.

1.0 Сокращенный паспорт проекта (также известен как Сокращенный устав проекта) 
1.0 Паспорт проекта (также известен как Устав проекта) 
1.0 Заявка на обслуживание 
2.0 План работ по управлению проектом (MS Project) 
4.0 Журнал учета вопросов/проблем 
4.0 Форма регистрации вопроса/проблемы 
5.0 Журнал запросов на изменение 
5.0 Форма запроса на изменение объема    
6.0 Персональный статус-отчет    
6.0 Отчет по состоянию проекта    
9.0 Программа качества проекта    
10.0 Карта показателей проекта    
10.0 Анкета удовлетворенности заказчика 

Автор: arilou 14.2.2008, 10:09

 ! 
arilou
пользователь zbuk получил читательский билет на 5 дней и премодерацию на 20 дней за рекламу

Powered by Invision Power Board (http://www.invisionboard.com)
© Invision Power Services (http://www.invisionpower.com)