![]() |
|
![]() ![]() ![]() |
|
Str!pe |
|
|||
профиль удален ![]() ![]() ![]() ![]() Профиль Группа: Участник Сообщений: 2426 Регистрация: 12.6.2005 Где: На земле. Репутация: нет Всего: 152 |
добрый день всем.
Кто что может подсказать по теме документации по проекту. Интересет как это вообще делается. Пока сижу все на коленях делаю. Может у кого есть подобный опыт? -------------------- Со мной можно связаться по скайпу или по аське. Занимаюсь продвижением сайтов - самой таргетированной рекламой. |
|||
|
||||
Rodman |
|
|||
CIO ![]() ![]() ![]() ![]() Профиль Группа: Участник Сообщений: 6144 Регистрация: 7.5.2006 Где: Ukraine ⇛ Kyiv ci ty Репутация: нет Всего: 122 |
не уверен, но посмотри такое
|
|||
|
||||
arilou |
|
|||
![]() Великий МунаБудвин ![]() ![]() ![]() ![]() Профиль Группа: Экс. модератор Сообщений: 2646 Регистрация: 15.7.2004 Где: город-герой Минск Репутация: 2 Всего: 61 |
Str!pe, "на коленях" - это без документации?
|
|||
|
||||
chief39 |
|
|||
![]() карманная тигра ![]() ![]() ![]() Профиль Группа: Участник Клуба Сообщений: 1631 Регистрация: 20.5.2005 Где: Киев Репутация: 4 Всего: 77 |
Могу дать полный набор заготовок с пояснениями для RUP.
на аглицком. Но, боюсь, что это обилие инфы просто завалит тебя и нихрена не поможет. "Иногда гвозди всё-таки лучше забивать гвоздём а не свайной машиной" ![]() Опиши размер проекта, что предполагется, сколько людей писать будут и кто заказчик(перед кем отчитываться). И вообще -суть проекта. Будет ли он меняться в корне, что-то вполне конкретное .или тёмная лошадка. Может тебе много чего и не понадобится. Добавлено @ 16:23 Да-да! Что именно на коленях делаешь? ![]() Творение творишь? Или документацию наобум сляпываешь? -------------------- Люди - это свечи. Они либо горят, либо их - в жопу!(с) |
|||
|
||||
bilbobagginz |
|
|||
![]() Naughtius Maximus ![]() ![]() ![]() ![]() Профиль Группа: Экс. модератор Сообщений: 8813 Регистрация: 2.3.2004 Где: Israel Репутация: 1 Всего: 317 |
если вопрос о документации кода, и представлении оной в напр. html-ном виде, то есть инструменты.
если вопрос о документе планировки, то это делается и пришивается в проект, до реализации. если вопрос о документации для пользователя, то легче всего взять смежную область, какое-то ПО, дока которого тебе нравится, и брать идеи оттуда. в больших конторах используется человеческий компилятор документации - "технический писатель" имхо всё конечно. -------------------- Я ещё не демон. Я только учусь. |
|||
|
||||
hetman |
|
|||
![]() Новичок Профиль Группа: Участник Сообщений: 2 Регистрация: 26.2.2007 Где: Moscow Репутация: нет Всего: нет |
Для ведения документации проекта очень рекомендую DocBook спецификацию, на первый взгляд сильно сложно но потом когда разберешся уже ничего кроме этого юзать не сможешь. |
|||
|
||||
unicuum |
|
|||
![]() Опытный ![]() ![]() Профиль Группа: Участник Сообщений: 830 Регистрация: 16.3.2005 Где: Рашка Репутация: -1 Всего: 8 |
Знаем мы что ты на коленях делаешь ![]() ![]() Думал над темой документации, читал книги, и вот к какому выводу пришёл. Какие бы системы ни пришлось для этого использовать, основная суть все равно идёт от создателя системы. Так чего думать то, пиши, так как единственный выход улучшить этот процесс это поручить его другому. ![]() -------------------- ![]() обычный день на винграде |
|||
|
||||
Str!pe |
|
||||||||
профиль удален ![]() ![]() ![]() ![]() Профиль Группа: Участник Сообщений: 2426 Регистрация: 12.6.2005 Где: На земле. Репутация: нет Всего: 152 |
Сори за то что задал вопрос и пропал.
Есть прочтенный "Мифический человеко месяц" и никакого опыта. Задача формулируется так: Описать проект и задать задачу программисту и дизайнеру.
Три человека, делаем web-сервис, задачи очень конкретные в голове, а вот как эту конкретику донести до разарботчиков не треща по скайпу (удаленная команда), а выдав бумаг пачку что бы от туда и дальше черпать информацию а не ко мне с вопросами. Мне не нужен талмуд с историей гостов (хоть и интернесно), нужны какието общае рекомендации для начала.
Вполне конкретная тематика.
документацию сляпываю ![]()
Во! А как его составить? Она от меня идет! От остальных корректировки которые я могу и отклонить без обьяснения причин. Добавлено через 36 секунд А где это взять? И мануалы к ней.... Добавлено через 1 минуту и 48 секунд Не оно :( -------------------- Со мной можно связаться по скайпу или по аське. Занимаюсь продвижением сайтов - самой таргетированной рекламой. |
||||||||
|
|||||||||
chief39 |
|
|||
![]() карманная тигра ![]() ![]() ![]() Профиль Группа: Участник Клуба Сообщений: 1631 Регистрация: 20.5.2005 Где: Киев Репутация: 4 Всего: 77 |
Гм.... ну чтоб вот так сразу уже на ходу и не возиться с проджект планами, конфигурейшн планами и проч(если проект не растягивается на долгое время и не окажется что это всё неплохо бы было иметь).
А также, если эта дока будет нужна только вам. Описание общего видения системы, требования к функциональности, производительности, заделы для расширения. Опиши требования(юзкейсы) к каждой функциональности. Чтоб человек брал требование и начинал писать(допроектировать) некий подмодуль уже по нему. Опиши список задач и укажи в пределах какой задачи что будет выполнено. Наметь сроки(учти что фиг угадаешь со сроками обычно сразу ![]() Опиши список тестируемых функциональностей и тестов, коотрые должны работать(опираясь на юзкейсы). Опиши требуемую конфигурацию для всех (мини конфигурейшн план). То есть "такой-то томкат, такая-то версия того-то, установлено так и так, бежит под такой-то осью". Иначе потом начнётся "а у меня под виндой работало... ничё не знаю." Там же укажи где и как хранятся сорцы, как и что можно изменять, какие настройки, их изменение и вообще, работа с ними Для составления плана удобно юзать мс проджект, хотя есть куча платных и бесплатных аналогов. Юзкейсы и тестовые планы описывай от руки, как Бог на душу положит - чтоб вам всем было понятно и больше конкретики. То есть, не пиши "должно примерно так работать....", а пиши "то и то. Вызвали то - отработало вот так. при вызове - не должен изменяться такой-то объект и бла-бла". То есть учти сразу где может быть излишний полёт фантазии. Если полёт всё-таки есть - документируйте его, т.е. изменяйте требования. Есть ещё куча всего, но, думаю, сейчас тебе это будет только в напряг. -------------------- Люди - это свечи. Они либо горят, либо их - в жопу!(с) |
|||
|
||||
Str!pe |
|
|||
профиль удален ![]() ![]() ![]() ![]() Профиль Группа: Участник Сообщений: 2426 Регистрация: 12.6.2005 Где: На земле. Репутация: нет Всего: 152 |
Моно хоть какой то примерчик, кусок выдраный хоть откуда, даж если не настоящий? Что за зверь? -------------------- Со мной можно связаться по скайпу или по аське. Занимаюсь продвижением сайтов - самой таргетированной рекламой. |
|||
|
||||
arilou |
|
|||
![]() Великий МунаБудвин ![]() ![]() ![]() ![]() Профиль Группа: Экс. модератор Сообщений: 2646 Регистрация: 15.7.2004 Где: город-герой Минск Репутация: 2 Всего: 61 |
||||
|
||||
Str!pe |
|
|||
профиль удален ![]() ![]() ![]() ![]() Профиль Группа: Участник Сообщений: 2426 Регистрация: 12.6.2005 Где: На земле. Репутация: нет Всего: 152 |
arilou,
Вот не учил я, не учил английский, теперь придется! Спасибо, буду разбираться что это такое ![]() Это сообщение отредактировал(а) Str!pe - 27.3.2007, 10:09 -------------------- Со мной можно связаться по скайпу или по аське. Занимаюсь продвижением сайтов - самой таргетированной рекламой. |
|||
|
||||
arilou |
|
|||
![]() Великий МунаБудвин ![]() ![]() ![]() ![]() Профиль Группа: Экс. модератор Сообщений: 2646 Регистрация: 15.7.2004 Где: город-герой Минск Репутация: 2 Всего: 61 |
Str!pe, по-русски это называется вроде "прецеденты использования", или что-то вроде.
|
|||
|
||||
chief39 |
|
|||
![]() карманная тигра ![]() ![]() ![]() Профиль Группа: Участник Клуба Сообщений: 1631 Регистрация: 20.5.2005 Где: Киев Репутация: 4 Всего: 77 |
Например модуль "банки"
Он отвечает за хранение, предоставление, изменение информации о банках в системе источник данных - такие-то таблицы в общей БД(может какие-то требования или указание конкретной СУБД) или такая-то специальная БД, механизм выборки и обработки реализован в фасаде или таком-то модуле, он должен интергироваться с тем-то, так-то (и всё что полезно разработчику знать) кэйсы: Получить "банк" - такой-то метод с такими то аттрибутами банка, такие-то аттрибуты важны, влияют(может быть) таким-то образом. UI должен: вызывать этот метод, отображать то и то, отображать результаты в таком виде(или таком, или настраиваться так и так) Можно вплоть до скриншотов Создать - так и так, этот аттрибут обязателен, эти данные доизвлекаются из такого-то модуля таким-то образом, УИ - оповещение о создании, отображение созданного, такие-то подсказки и словари данных и др и др.. Изменить Удалить Не допускать того-то Испоьлзовать тот и тот модуль То есть вам будет полезен документ где описано видение функционала, ограничения, требования пользователя. С этим девелопер может начинать детально проектировать модуль, подгонять его под остальные и общие, разрабатывать части и одновременно тестер может описывать тест-кэйсы по этому документу. Кроме того, полезно описать программные интерфейсы для взаимодействия модулей То есть писать Какие действия надо протестировать, какие вараинты входных данных, ожидаемые результаты и проч и проч. Аутомейтед-тестер может начинать писать автоматические/юнит-тесты И в момент когда выйдет первый релиз модуля оба могут сразу упрогнать тесты и показать разработчику что пошло не так, чтоб он ориентировался уже на реалии, а не писал с закрытыми глазами тонны кода дальше Кроме того, вам полезно будет описать общий документик(можно это всё в один слить) туда внести code conventions(требования к форматированию кода, именованию переменных, общих принципов проектирования классов, методов и подмодулей) - (если надо). общие соглашения по УИ или внешним неким интерфейсам - тем самым избаляешь разработчиков от львиной доли колебаний при решении какую картинку поместить на форму, как распоолжить поля, как спроектировать и назвать некие внешине методы програмного интерфейса. пардон, времени мало... -------------------- Люди - это свечи. Они либо горят, либо их - в жопу!(с) |
|||
|
||||
Str!pe |
|
|||
профиль удален ![]() ![]() ![]() ![]() Профиль Группа: Участник Сообщений: 2426 Регистрация: 12.6.2005 Где: На земле. Репутация: нет Всего: 152 |
Сейчас все мои действия сводятся к том что я делаю полностью макет страницы с расположением элементов. Все собираю в HTML - получается наглядный рабочий вариант, но без минимального дизайна. Каждый модуль разобран в отдельной странице по пунктам:
Фактически стараюсь делать полностью работоспособный проект (стандартными Дримуверовскими скриптами) который описываю, что не могу сделать просто обьясняю на пальцах... делает ли кто ни будь так же? И в чем собирает прототипы проекта? -------------------- Со мной можно связаться по скайпу или по аське. Занимаюсь продвижением сайтов - самой таргетированной рекламой. |
|||
|
||||
![]() ![]() ![]() |
|
НА ЗЛОБУ ДНЯ: Дорогие посетители, прошу обратить внимание на то, что новые темы, касающиеся новых вопросов, создаются кнопкой "Новая тема", а не "Ответить"! Любые оффтопиковые вопросы, заданные в текущих темах, будут удалены. Если Вам понравилась атмосфера форума, заходите к нам чаще! С уважением, arilou. |
1 Пользователей читают эту тему (1 Гостей и 0 Скрытых Пользователей) | |
0 Пользователей: | |
« Предыдущая тема | УП: Общие вопросы | Следующая тема » |
|
По вопросам размещения рекламы пишите на vladimir(sobaka)vingrad.ru
Отказ от ответственности Powered by Invision Power Board(R) 1.3 © 2003 IPS, Inc. |